Want to keep your systems up to date with ours? See every time someone on your account buys a number? Adds a sip account? Yeah. Just set up your web hook url and you can.
The high level overview of what is happening here is that whenever something happens on your account, we send a web call with the pertinent data. All calls will have the basic format:
1
{
2
"type":"update",
3
"schema":"dids",
4
"data":"{ dids object }"
5
}
Copied!
type
The type will be one of three things: insert, update, delete.
Insert for a new record
Update if we've modified an existing record
Delete if that record has been removed
schema
Basically, just the object type. What was it that was insert, updated or deleted.
data
This is the meat of the hook. Every different schema type will have different data here, but in short it is a JSON string (will need a parse on your end) that has all the associated information for a record.
Schemas
List of the fields available for each schema type. Always do do diligence and check if a field is in the object before using it, rather than just assuming.