Managed accounts

Managed account state change

Sent each time a managed account is created or changes state, so you can track an account from the moment it is requested through to closure without polling.

Enable and configure webhooks in the Embedder Portal; recent events are listed on its Webhook Logs page. Weavr sends this event to {Webhook URL}/managed_accounts/watch.

postWebhook/managed_accounts/watch

Headers

call-refstring

A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

published-timestampinteger required

The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

signaturestring required

The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

signature-v2string required

The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

Payload

publishedTimestampinteger required

When the event was published. Epoch timestamp using millisecond precision.

type'CREATED' | 'UPDATED' | 'REQUESTED' | 'REJECTED' | 'BLOCKED' | 'UNBLOCKED' | 'DESTROYED' required

What happened to the managed account:

  • REQUESTED: creation was requested and is awaiting issuance.
  • CREATED: the account was issued and can be transacted on.
  • UPDATED: the account's details changed.
  • REJECTED: the creation request was rejected.
  • BLOCKED: the account was blocked and cannot transact.
  • UNBLOCKED: the account was unblocked and can transact again.
  • DESTROYED: the account was permanently closed. This is a final state.

Example payload

{
  "account": {
    "id": "123456789",
    "profileId": "10001",
    "tag": "customer-123",
    "friendlyName": "Main GBP account",
    "currency": "GBP",
    "balances": {
      "availableBalance": 120000,
      "actualBalance": 125000
    },
    "creationTimestamp": 1786118400000,
    "lowBalanceThreshold": 10000,
    "owner": {
      "type": "example",
      "id": "123456789"
    },
    "active": true,
    "bankAccountDetails": {
      "accountNumber": "31926819",
      "address": "1 High Street, London W1A 1AA",
      "bankIdentifierCode": "NWBKGB2L",
      "beneficiaryBank": "National Westminster Bank PLC",
      "iban": "GB29NWBK60161331926819",
      "paymentReference": "Invoice 1042",
      "sortCode": "601613"
    }
  },
  "publishedTimestamp": 1786118400000
}

Response

Event received.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.