Skip to main content
All webhook endpoints require owner role.

List webhooks

page
integer
default:"1"
Page number
per_page
integer
default:"25"
Items per page (max 250)
sort
string
Sort field
order
string
default:"desc"
Sort order: asc or desc
status
string
Filter by status: active, paused, or failed
GET /api/v1/webhooks

Create a webhook

POST /api/v1/webhooks
url
string
required
Webhook endpoint URL (must be HTTPS)
events
string[]
required
Array of event types to subscribe to

Available event types

EventTrigger
contact.createdContact created
contact.updatedContact updated
contact.deletedContact deleted
company.createdCompany created
company.updatedCompany updated
deal.createdDeal created
deal.updatedDeal updated
deal.stage_movedDeal stage changed
interaction.createdInteraction logged
commitment.completedCommitment completed
followup.completedFollow-up completed
Example
curl -X POST https://api.mosscrm.com/api/v1/webhooks \
  -H "X-API-Key: moss_k_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.example.com/moss",
    "events": ["contact.created", "deal.stage_moved"]
  }'

Update a webhook

PATCH /api/v1/webhooks/:id
url
string
Webhook endpoint URL
events
string[]
Event types to subscribe to
status
string
Status: active or paused

Delete a webhook

DELETE /api/v1/webhooks/:id