Skip to content
Docs/
/
/
Beneficiary

Beneficiary Webhooks

Beneficiary webhooks notify you about beneficiary lifecycle events.

Note: The sample payloads on this page are pretty-printed. The body Glomo sends is the RFC 8785 canonical form of the same object, and the X-Glomopay-Signature header is computed over those bytes. See Webhook Authentication & Security.

Event TypeDescription
active The beneficiary has been approved and is active.
rejected The beneficiary has been rejected.

Sample Payload

{
  "entity_type": "beneficiary",
  "event_type": "active",
  "data": {
    "id": "bene_6989dfe1AgGFI",
    "name": "Test auto approve 2",
    "category": "payout",
    "email": "finance@acme.com",
    "phone": "+14155551234",
    "nickname": "ACME Primary Account",
    "status": "active",
    "created_at": "2026-02-09T13:23:45Z",
    "updated_at": "2026-02-09T13:24:42Z",
    "type": "business",
    "documents": [
      "doc_68e7980auYRAs"
    ],
    "address": {
      "address_line1": "123 Business Park",
      "address_line2": "Suite 100",
      "city": "New York",
      "state": "NY",
      "country_code": "USA",
      "postal_code": "10001"
    },
    "bank_account": {
      "account_number": "1234657557",
      "name": "Citibank NA",
      "swift_code": "CITIUS33",
      "local_routing_number": "021000089",
      "currency": "USD",
      "address": {
        "address_line1": "388 Greenwich Street",
        "address_line2": null,
        "city": "New York",
        "state": "NY",
        "country_code": "USA",
        "postal_code": "10013"
      },
      "intermediate_bank": {
        "name": "JPMorgan Chase Bank",
        "country": "USA",
        "swift_code": "CHASUS33",
        "account_number": "123456789"
      }
    },
    "upi_account": null
  }
}

Payout

Refund