Skip to main content

Webhook

HTTP endpoint that receives MONEI events. Each delivery is signed with the account's API key (MONEI-Signature: t=<unix>,v1=<hmac-sha256> over <unix>.<body>). Failed deliveries are retried with exponential backoff; the webhook is automatically disabled and lastResponse recorded once retries are exhausted.

type Webhook {
  id: ID!
  accountId: ID!
  url: String!
  eventTypes: [WebhookEventType!]!
  secret: String
  enabled: Boolean!
  createdAt: String!
  updatedAt: String
  lastResponse: CallbackData
}

Fields​

Webhook.id ● ID! non-null scalar​

Webhook ID.

Webhook.accountId ● ID! non-null scalar​

Account that owns the webhook.

Webhook.url ● String! non-null scalar​

HTTPS endpoint MONEI POSTs events to.

Webhook.eventTypes ● [WebhookEventType!]! non-null enum​

Event types this webhook subscribes to.

Webhook.secret ● String scalar​

Sensitive: legacy per-webhook signing secret. New webhooks sign with the account API key; this is kept for backward compatibility.

Webhook.enabled ● Boolean! non-null scalar​

Whether the webhook is active. Auto-set to false after retries are exhausted.

Webhook.createdAt ● String! non-null scalar​

Creation timestamp (ISO 8601).

Webhook.updatedAt ● String scalar​

Last update timestamp (ISO 8601).

Webhook.lastResponse ● CallbackData object​

Outcome of the most recent delivery attempt.

Returned By​

createWebhook mutation ● updateWebhook mutation ● webhook query

Member Of​

WebhooksConnection object