Webhook API

These endpoints receive server-to-server webhook events from trusted integrations.

Authentication

Webhook endpoints require:

• Authorization: Bearer <s2s-token>

Base URL and common headers

• Base URL: Base Domains

• Header: Content-Type: application/json

Endpoint overview

Method	Path	Purpose
POST	/idp/array/webhook	Receive Array webhook events
POST	/idp/payments/webhook	Receive payment webhook events
POST	/idp/payments/webhook/plan-change	Receive payment plan-change webhook events

Endpoint Reference

POST /idp/array/webhook

• Description: receive Array webhook events

• Authentication: server-to-server bearer token

Request body:

• JSON payload provided by the Array integration

Example request:

{
  "eventType": "example_event",
  "data": {}
}

Responses on success:

• 200 OK

POST /idp/payments/webhook

• Description: receive payment webhook events

• Authentication: server-to-server bearer token

Request body:

• JSON payload provided by the payments integration

Example request:

{
  "eventType": "subscription_cancelled",
  "data": {}
}

Responses on success:

• 200 OK

POST /idp/payments/webhook/plan-change

• Description: receive payment plan-change events

• Authentication: server-to-server bearer token

Request body:

• JSON payload provided by the payments integration

Example request:

{
  "eventType": "plan_changed",
  "data": {}
}

Responses on success:

• 200 OK

{
  "message": "OK"
}