Create Account
This endpoint is deprecated. Use POST /v3/customers, which takes an Idempotency-Key so a retry cannot create the customer twice. It keeps working while integrations move; see Versioning.
This endpoint allows you to create an account.
Takes a workspace-scoped API key. An account-scoped key is refused with 403.
Authorization:
Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.
Headers:
Authorization: APIKey {SIGNED_JWT}
How to build and sign the JWT: Authentication.
Endpoint
/api/v2/accounts
Request Body Sample
{
"accountType": "individual",
"email": "jwick@example.com",
"accountName": "Wick's Account",
"firstName": "John",
"lastName": "Wick",
"reference": "client-reference-123"
}
Request Body Schema
| Field | Type | Description |
|---|---|---|
accountType | string | Required Account type. Values: individual or business. |
email | string | Required Email. Example: jwick@example.com. |
accountName | string | Required Account name. Example: Wick's Account. |
firstName | string | Required First name. Example: John. |
lastName | string | Required Last name. Example: Wick. |
reference | string | Client reference. Example: client-reference-123. default: uuidv7 |
Response Sample
{
"id": "00000000-0000-0000-0000-000000000000",
"reference": "client-reference-123",
"accountType": "individual",
"email": "jwick@example.com",
"accountName": "Wick's Account",
"firstName": "John",
"lastName": "Wick",
"status": "pending",
"createdAt": "2025-04-07T15:32:01.411Z",
"updatedAt": "2025-04-07T15:32:01.411Z"
}
Support and Resources
If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.
Stay Updated
Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:
- Instagram: BlockWyre Instagram
- Twitter: BlockWyre Twitter
- Facebook: BlockWyre Facebook
- LinkedIn: BlockWyre LinkedIn
We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!