v1

Swagger 2.02026-07-13107162315.5 KB
Webhook

Creates a new webhook subscription. On success, returns the ID of the new webhook subscription.

When you receive a webhook, you should respond with Http 200 OK Status Code, otherwise we will retry. To create a webhook, you need both the webhook_notifications scope, as well as the scope for the required entity being monitored. Event values are: "company_created", "company_deleted", "company_updated", "contact_created", "contact_deleted", "contact_updated", "invoice_created", "invoice_sent","invoice_updated","invoice_deleted", "project_created", "project_deleted", "project_updated", "task_created", "task_updated","task_deleted", "timesheet_created", "timesheet_deleted", "timesheet_updated, "bill_created", "bill_updated", "estimate_created", "estimate_updated", "estimate_deleted", "expense_created", "expense_updated", "expense_deleted", "scheduleseries_created", "scheduleseries_updated", "scheduleseries_deleted", "team_member_created", "team_member_updated", "team_member_deleted". You can subscribe to any webhook, but you will only receive notifications for data appropriate to the roles of your user account. There is an optional Secret parameter (string 255 char max). This allows for webhook authentication. If provided, the Secret will be BASE 64 encoded and passed with notications as a basic authentication http header. i.e. Authorization Basic [BASE64 of Secret]"

post/api/Webhook

Request body

target_urlstring required

The URL that should be notified of the event.

eventstring required

The event code to be notified about. Possible values: company_created, company_deleted, company_updated, contact_created, contact_deleted, contact_updated, invoice_created, invoice_sent, invoice_updated, invoice_deleted, project_created, project_deleted, project_updated, task_created, task_updated, task_deleted, timesheet_created, timesheet_deleted, timesheet_updated, bill_created, bill_updated, estimate_created, estimate_updated, estimate_deleted, team_member_created, team_member_updated, team_member_deleted

secretstring

Optional Secret string (255 char max). If provided, the secret will be BASE 64 encoded and used as a basic authentication http header with webhook notifications. i.e. Authorization Basic [BASE64 of Secret]"

Response

Subscription created

IDinteger

The ID of the newly created webhook subscription.