Skip to main content
You can set up webhooks either via the Partoo interface or through the API.
From the app interface:
Webhook listing in the Partoo interface
  1. Go to Settings > Integrations > Webhooks
  2. Click Create to add a new webhook
  3. Provide a valid callback URL and choose one or more event types
  4. Optionally, test the endpoint before saving
Webhook creation form with callback URL and event type
You can register up to 5 webhooks per event type per organization. Each must use a unique URL — all registered URLs receive the event. The same URL can be reused across different event types.
1

Choose the events you want to subscribe to

Each event type is independent. Choose only the ones you need.
2

Provide your webhook URL

You must supply a valid HTTPS URL that can receive POST requests.
You can register up to 5 webhooks per event type per organization. Each must use a unique URL — all registered URLs receive the event. The same URL can be reused across different event types. Exceeding the limit returns a 400 error.
3

Include your org_id and event types

We use the org_id to ensure events go to the right organization.Required fields:
  • url – your endpoint
  • org_id – your organization ID
  • event_type – the event to subscribe to
Optional fields:
  • custom_headers – custom HTTP headers to forward with each webhook request (e.g. for authentication). Keys must start with X- and must not use the X-Partoo prefix. Maximum 5 headers. Key max length: 128 characters. Value max length: 512 characters. The following characters are forbidden in header keys: space, (, ), <, >, @, ,, ;, :, \, ", /, [, ], ?, =, {, }.
4

Verify response behavior

You must return a 200 OK response to acknowledge receipt.
If your server returns a 5xx error, we retry the request up to 5 times with exponential backoff.
For other errors (4xx), no retries occur.