Create child org - Etherfuse API

curl --request POST \ --url https://api.etherfuse.com/ramp/organization \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data ' { "accountType": "personal", "displayName": "Ana García", "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "userInfo": { "displayName": "Ana García", "email": "[email protected]" }, "wallets": [ { "blockchain": "stellar", "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL" } ] } '

Account types

Every organization has an accountType of either personal (an individual customer completing KYC) or business (a company completing KYB). The two are handled differently downstream: personal orgs go through individual KYC and Plaid; business orgs go through KYB and skip per-wallet compliance.

personal — pass userInfo so the end user records are created and we can email them on status changes.

business — userInfo is rejected (business orgs do not have a single end user).

accountType is currently optional and defaults to personal. It will become required in a future release — start sending it explicitly now.

Authorizations

Authorization

string

header

required

API key sent in the Authorization header.

Body

application/json

accountType

string | null

Optional. Defaults to personal. Will become required in a future release once partners have migrated.

Example:

"personal"

bankAccount

object

Show child attributes

Example:

{
  "account": {
    "birthCountryIsoCode": "MX",
    "birthDate": "1990-05-15",
    "clabe": "646180157000000004",
    "curp": "GALA900515MDFRPN08",
    "firstName": "Ana",
    "maternalLastName": "López",
    "paternalLastName": "García",
    "rfc": "GALA900515AB1",
    "transactionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
  },
  "bankAccountId": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "label": "Ana's SPEI account",
  "skipAutoApproval": false
}

displayName

string | null

string<uuid> | null

userInfo

object

Optional info about the end user. Required eventually for personal orgs. Rejected on business orgs (those don't have a single end user).

Show child attributes

wallets

object[]

Show child attributes

Response

The created child organization

displayName

string

required

organizationId

string<uuid>

required

wallets

object[]

required

Show child attributes

accountType

string | null

Example:

"personal"

bankAccount

object

Show child attributes

Example:

{
  "abbrClabe": "•••• 0004",
  "bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "compliant": true,
  "createdAt": "2026-05-01T14:30:00Z",
  "currency": "MXN",
  "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "etherfuseDepositClabe": "646180157000000004",
  "label": "Ana's SPEI account",
  "needsWork": false,
  "status": "active",
  "updatedAt": "2026-05-02T09:15:00Z"
}