Skip to main content

Webhooks

Setup real-time notifications of events in Ring4 to create custom workflows in your business.

E
Written by Ed Mallory
Updated over 2 weeks ago

Send real-time call and message events from your Ring4 account to any app that can receive them.

With webhooks, you can automate workflows like contact updates and inbound SMS.

Get Started

  1. Create your webhook endpoint in your favorite tool (Make.com, n8n.io, Zapier.com, Pipedream.com, etc.)

  2. Start a conversation with us (lower right of this page) and share your webhook endpoint. Let us know which of these events you would like to trigger.

    1. sms_received

    2. contact_created

    3. contact_updated

    4. contact_deleted

  3. Ring4 will create the webhook and let you know when it's ready.

Inbound SMS webhook event sample

[
{
"data": {
"assets": "",
"body": "Hello world",
"from": "18584424039",
"messageId": 59590,
"receivedAt": 1750358074779182300,
"to": "12015023123"
},
"event": "sms.received",
"timestamp": 1750358074779182300
}
]

Contact created webhook event sample

[
{
"data": {
"company": "ACME Auto Parts",
"createdAt": 1750359787137841400,
"email": "[email protected]",
"firstName": "Floyd",
"id": 19040,
"lastName": "Miles",
"phone": "18585551234"
},
"event": "contact.created",
"timestamp": 1750359787139428000
}
]

Contact updated webhook event sample

[
{
"data": {
"company": "company",
"email": "[email protected]",
"firstName": "Jenny",
"id": 19040,
"lastName": "Wilson",
"phone": "18585551234",
"updatedAt": 1750360067660882000
},
"event": "contact.updated",
"timestamp": 1750360067662218500
}
]

Contact deleted webhook event sample

[
{
"data": {
"company": "",
"deletedAt": 1750360378542673700,
"email": "",
"firstName": "",
"id": 19040,
"lastName": "",
"phone": "18585551234"
},
"event": "contact.deleted",
"timestamp": 1750360378546349300
}
]

Proptery name notes

  • timestamp is in nanoseconds since epoch format

Did this answer your question?