API Reference

The Beeving API v1 exposes 145+ endpoints organized by module.

Base URL

https://app.beeving.com/api/v1

All Endpoints

Contacts

Method	Endpoint	Description
GET	/contacts	List contacts
POST	/contacts	Create a contact
POST	/contacts/bulk	Bulk create
POST	/contacts/import	Import from CSV
GET	/contacts/export	Export to CSV
GET	/contacts/{id}	Get contact
PUT	/contacts/{id}	Update contact
DELETE	/contacts/{id}	Delete contact
GET	/contacts/{id}/timeline	Event history
POST	/contacts/{id}/unsubscribe	Unsubscribe

Lists

Method	Endpoint	Description
GET	/lists	List all lists
POST	/lists	Create a list
GET	/lists/{id}	Get list
PUT	/lists/{id}	Update list
DELETE	/lists/{id}	Delete list
GET	/lists/{id}/contacts	List contacts
POST	/lists/{id}/contacts	Add contacts
DELETE	/lists/{id}/contacts	Remove contacts

Tags

Method	Endpoint	Description
GET	/tags	List tags
POST	/tags	Create a tag
GET	/tags/{id}	Get tag
PUT	/tags/{id}	Update tag
DELETE	/tags/{id}	Delete tag
GET	/tags/{id}/contacts	Tagged contacts
POST	/tags/{id}/contacts	Tag contacts

Segments

Method	Endpoint	Description
GET	/segments	List segments
POST	/segments	Create a segment
GET	/segments/{id}	Get segment
PUT	/segments/{id}	Update segment
DELETE	/segments/{id}	Delete segment
GET	/segments/{id}/contacts	Segment contacts
GET	/segments/{id}/preview	Preview

Campaigns

Method	Endpoint	Description
GET	/campaigns	List campaigns
POST	/campaigns	Create a campaign
GET	/campaigns/{id}	Get campaign
PUT	/campaigns/{id}	Update campaign
POST	/campaigns/{id}/start	Start
POST	/campaigns/{id}/pause	Pause
POST	/campaigns/{id}/resume	Resume
POST	/campaigns/{id}/duplicate	Duplicate
GET	/campaigns/{id}/stats	Statistics
GET	/campaigns/{id}/analytics	Analytics
GET	/campaigns/{id}/export	Export results

CRM — Companies

Method	Endpoint	Description
GET	/crm/companies	List companies
POST	/crm/companies	Create a company
GET	/crm/companies/{id}	Get company
PUT	/crm/companies/{id}	Update company
DELETE	/crm/companies/{id}	Delete company
GET	/crm/companies/{id}/contacts	Company contacts
GET	/crm/companies/{id}/leads	Company leads
GET	/crm/companies/{id}/deals	Company deals

CRM — Leads

Method	Endpoint	Description
GET	/crm/leads	List leads
POST	/crm/leads	Create a lead
GET	/crm/leads/{id}	Get lead
PUT	/crm/leads/{id}	Update lead
DELETE	/crm/leads/{id}	Delete lead
POST	/crm/leads/{id}/convert	Convert to deal
POST	/crm/leads/{id}/recalculate-score	Recalculate score

CRM — Deals

Method	Endpoint	Description
GET	/crm/deals	List deals
POST	/crm/deals	Create a deal
GET	/crm/deals/{id}	Get deal
PUT	/crm/deals/{id}	Update deal
DELETE	/crm/deals/{id}	Delete deal
POST	/crm/deals/{id}/won	Mark as won
POST	/crm/deals/{id}/lost	Mark as lost

CRM — Tasks

Method	Endpoint	Description
GET	/crm/tasks	List tasks
POST	/crm/tasks	Create a task
GET	/crm/tasks/{id}	Get task
PUT	/crm/tasks/{id}	Update task
DELETE	/crm/tasks/{id}	Delete task
POST	/crm/tasks/{id}/complete	Mark as complete

CRM — Pipeline

Method	Endpoint	Description
GET	/crm/pipeline	List stages
POST	/crm/pipeline	Create a stage
POST	/crm/pipeline/reorder	Reorder stages
PUT	/crm/pipeline/{id}	Update stage
DELETE	/crm/pipeline/{id}	Delete stage