Web Hooks

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:

{
"type": "update",
"schema": "dids",
"data": "{ dids object }"
}

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.