Docs
Get API key

Webhooks

What you receive

Each event is a POST with a JSON body. Every event has the same shape: workspace, lead, campaign, sender, message and conversation, each null when the event doesn’t have one, plus link, which opens it in Salesteam. Campaign and account events have no lead.

Some events add one more part:

EventAdds
lead.taggedtag: the tag’s ID and name
lead.finishedfinish.reason: completed, replied, stopped, not_accepted, moved or suppressed
post.likedpost.url: the post that was liked
campaign.completedresults: people in the campaign, contacted, accepted and replied
campaign.requests_pausedacceptance: requests sent and accepted, the rate and your safety line
account.disconnectedaccount: how many running campaigns wait for the account (sender)
HeaderWhat it holds
X-Salesteam-EventThe event type, like lead.replied
X-Salesteam-DeliveryThe event’s ID, the same on every retry. Use it to skip repeats.
X-Salesteam-TimestampUnix seconds when this try was signed
X-Salesteam-Signaturev1= and the signature

Answer with any 2xx status within 10 seconds. Events usually arrive within a minute of happening.