Docs for all releases
Page History
...
A typical handler should be configured as is HTTPS or HTTP with an URL of the script, which will get HTTP POST requests about each event occurrence.
Please avoid using the Script type of the handlers, they are designed for internal usage within the system.
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Best practice example There is an example based on https://hostname/handler-endpoint usage. Open the Provisioning section and start creating a handler.
Find an example of the http://handler below:
|
Supported Events
The Provisioning API supports the following list of events:
- Clients
- clients.create
- clients.update
- clients.archive
- clients.delete
- clients.balance_zero
- clients.balance_notzero
- clients.custom_fields.update
- Accounts
- clients.accounts.create
- clients.accounts.update
- clients.accounts.delete
- Subscriptions
- clients.subscriptions.assign
- clients.subscriptions.activate
- clients.subscriptions.deactivate
- clients.subscriptions.renew
- clients.subscriptions.close
- Email Rates Manager
- email_rates_manager.import
- Import Manager
- importd.process_success
- importd.process_failed
Info | ||
---|---|---|
| ||
The |
Event Payload
Structure
During notification, the handler will be called with JSON-formatted data payload. The payload has following structure:
event
dt
- the date-time of the event in the ISO8601 format;events_id
- ID of the event occurred (helpful, when multiple events are handled by the same handler);object_id
- the entity, to which the event happened;
data
- data related to the specific event.
Example
Code Block |
---|
{ "event": { "dt": "2000-01-01T00:00:00+00:00", "events_id": "clients.update", "object_id": 12 }, "data": { "id": 12, "field": "some-value" } } |
Data
The data provided within the notification depends on the specific type of event.
Events that represent basic status changes will not contain any additional data as the ID of the related entity is provided within the "event" key. Examples of such events are: clients.accounts.delete
, clients.archive
, clients.balance_notzero
, clients.balance_zero, etc.
For the rest of the events, the structure will match structure of the respective method in the CoreAPI CoreAPI method's structure. Please check the respective documentation within the system interface in the Integration/CoreAPI Docs section.
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Tip
|