Skip to main content

Webhooks

Adspire.AI stores incoming connector events via the Webhook Events API. Connectors normalize provider payloads and forward them to Adspire.AI.

Create webhook event​

POST /api/webhook-events

Required fields​

  • event_type (string): provider.topic (example: provider.resource/updated)
  • payload (object): provider payload with _meta appended

Optional fields​

  • connector_installation_id (integer)
  • status (string)
  • response (string)
  • attempts (integer)
  • sent_at (date-time)
  • next_retry_at (date-time)

Example body​

{
  "event_type": "provider.resource/updated",
  "payload": {
    "resource_id": "resource_123",
    "status": "updated",
    "_meta": {
      "source": "provider",
      "topic": "resource/updated",
      "received_at": "2024-01-01T12:00:00Z",
      "request_id": "uuid"
    }
  }
}

Normalization guidelines​

  • Use event_type as <provider>.<topic>.
  • Copy provider payload as-is, then append _meta for traceability.
  • Include provider-specific identifiers in _meta when available.