Quick Start
Make your first API call in under 5 minutes.
1. Create an API Token
In Beeving, go to Settings → API Tokens and create a new token with the desired permissions.
Copy the token: it will only be shown once.
2. Your First Request
Test your token by fetching your contacts:
bash
curl https://app.beeving.com/api/v1/contacts \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN"js
const response = await fetch('https://app.beeving.com/api/v1/contacts', {
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json',
},
})
const { data, meta } = await response.json()
console.log(`${meta.total} contacts found`)php
$ch = curl_init('https://app.beeving.com/api/v1/contacts');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_TOKEN',
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch), true);python
import requests
headers = {'Authorization': 'Bearer YOUR_TOKEN'}
r = requests.get('https://app.beeving.com/api/v1/contacts', headers=headers)
data = r.json()
print(f"{data['meta']['total']} contacts found")3. Create a Contact
bash
curl -X POST https://app.beeving.com/api/v1/contacts \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "alice@example.com",
"first_name": "Alice",
"last_name": "Martin",
"company_id": 3
}'Response 201:
json
{
"data": {
"id": 42,
"email": "alice@example.com",
"first_name": "Alice",
"last_name": "Martin",
"full_name": "Alice Martin",
"company_id": 3,
"company_name": "Acme Corp",
"company": { "id": 3, "name": "Acme Corp" },
"status": "active",
"lists": [],
"tags": [],
"created_at": "2026-02-23T10:00:00.000000Z"
}
}4. Create a CRM deal
Once you have a contact, create a deal linked directly to it:
bash
curl -X POST https://app.beeving.com/api/v1/crm/deals \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme opportunity",
"contact_id": 42,
"stage_id": 1
}'