Skip to main content
Webhooks allow your application to receive real-time notifications when events happen in your Bullring account. Instead of polling the API, we will send an HTTP POST request to your configured URL.

​
Subaccount Approved

{
    "data": {
        "id": "0480a605-03eb-4ab8-ae53-aac619cdce78",
        "email": "user@example.com",
        "status": "approved"
    },
    "event": "subaccount.status.approved"
}

​
Subaccount Created

{
    "data": {
        "id": "7625a677-44e1-4b96-b0d0-ba86af1b93cc",
        "email": "user@example.com",
        "status": "created"
    },
    "event": "subaccount.status.created"
}

​
Subaccount Declined

When a subaccount is declined, the payload includes a failure_reason and a boolean can_resubmit indicating if the user is allowed to try again. 
{
  "event": "subaccount.status.declined",
  "data": {
    "id": "7ae50606-4422-4b8d-8604-543686e4472d",
    "email": "dafe+vps139@bullring.finance",
    "status": "declined",
    "failure_reason": "BAD_PROOF_OF_ADDRESS",
    "can_resubmit": true
  }
}

​
Subaccount In Review

{
    "data": {
        "id": "7625a677-44e1-4b96-b0d0-ba86af1b93cc",
        "email": "user@example.com",
        "status": "review"
    },
    "event": "subaccount.status.review"
}