Action required

{ "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890", "customerId": "c1a2b3c4-d5e6-7890-abcd-ef1234567890", "owner": { "ownerType": "INDIVIDUAL", "firstName": "Maria", "lastName": "Silva", "taxId": { "value": "11222333000181", "type": "CNPJ", "country": "BR" }, "address": { "addressLine1": "Rua Augusta, 500", "city": "São Paulo", "country": "BR", "postalCode": "01304-001", "addressLine2": null, "state": "SP" }, "birthDate": "1990-03-21" }, "atTime": "2026-04-28T14:32:11Z", "sourceAccountId": null }

Authorizations

Authorization

string

header

required

JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.

Body

application/json

Payload delivered on ACCOUNT_CREATED and ACCOUNT_ACTION_REQUIRED. Both carry the account with its owner; the X-Event-Type header tells which transition fired.

string<uuid>

required

Account identifier.

Example:

"a1b2c3d4-5e6f-7890-abcd-ef1234567890"

customerId

string

required

Identifier of the customer that owns the account.

Example:

"c1a2b3c4-d5e6-7890-abcd-ef1234567890"

owner

Individual · object

required

Legal entity that owns the account. Discriminated by ownerType.

Individual
Company

Show child attributes

atTime

string<date-time>

required

When this event occurred. Distinct from the resource's createdAt — events fire on state transitions, so atTime reflects when the transition happened, not when the underlying resource was first created.

Example:

"2026-04-28T14:32:11Z"

sourceAccountId

string<uuid> | null

Parent account ID for sub-accounts. null for top-level accounts.

Example:

null

Response

200

Acknowledged. Trace Finance considers any 2xx response a successful delivery.

Accounts

Operations

Reports

Quotes

Beneficiaries

Webhooks

Authorizations

Body

Response