Your first conversation
From a server-side event to your Pingback inbox in a few steps.
Scale · Developer API betaCreate a workspace key
In the dashboard, open Channels / Developer API. Create an API key and save its one-time secret as PINGBACK_API_KEY on your server. Workspace owners and admins can create keys.
Send an event
curl https://api.pingback.live/api/v1/developer/events \
-H "Authorization: Bearer $PINGBACK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event": "conversation.created",
"external_id": "order-123-support",
"customer_email": "[email protected]",
"customer_name": "Amara",
"subject": "Delivery question",
"body": "Can I update my delivery address?"
}'Keep the conversation ID
{
"status": "accepted",
"event": "conversation.created",
"resource_id": "conv_example",
"event_id": "dev_evt_example"
}Find the conversation in Inbox. Keep resource_id to add another message to the same conversation. Retrying the same external_id returns status: duplicate and the original resource_id.