Articles on: Other

SWELLEnterprise Webhooks

How to use hooks with SWELLEnterprise RESTful API


Creating Subscriptions:

1- Create a subscription: sending a POST request to the https://app.swellsystem.com/api/subscribe after basic authentication with your username and password. 


Request body should have the endpoint and event this hook will subscribe to in the form of a JSON object // with appropriate headers


Authentication

==============


Basic Authentication with username and password


Subscriptions

===========


Subscription Endpoints

Get all subscriptions and events for user 


GET: https://app.swellsystem.com/api/subscribe


To create a subscription


POST: https://app.swellsystem.com/api/subscribe


Request body: should be of content type application/json, appropriate headers are needed


{

     "url" => endpoint,

     "event" => the trigger or event captured in swell,

}


To update a subscription


PATCH: https://app.swellsystem.com/api/subscribe/ + ID


Request body: should be of content type application/json, appropriate headers are needed


{

     "url" => new updated endpoint,

     "event" => new updated trigger or event captured in swell,

}


To delete a subscription/unsubscribe from an event


DELETE: https://app.swellsystem.com/api/subscribe/ + ID


Events

=======


Events for clients, leads, contacts, invoices are currently working and new events will be added and documented.


Example client event to subscribe to:


client.create


client.update


client.delete

Updated on: 10/30/2019

Was this article helpful?

Share your feedback

Cancel

Thank you!