Create Solo Account
POST /api/v1/solo-accounts: provision a solo creator account.
One call handles both cases. If the address is new to Easy2257, the creator is provisioned and emailed a link. If it already belongs to an Easy2257 user, that person is emailed and asked to approve the connection first, and their identity record stays unlinked until they do. The response is identical either way, so you write one branch, and your integration cannot be used to probe whether one of your users already has an Easy2257 account.
Until a creator on the consent path approves, POST and DELETE on that account's content return 409 with code CONSENT_PENDING, and CONSENT_DECLINED if they refuse. The solo_account.verified webhook fires only after approval. Re-provisioning is safe but is not a way to nag: the approval email goes out at most once per creator per day, and a creator who declines is never emailed about your platform again.
Authorization
BearerAuth Partner API key from partner.easy2257.com/api-keys. Only ez_live_ keys are accepted. A key beginning with ez_test_ is rejected with 403 and code TEST_MODE_UNAVAILABLE before any handler runs: there is no sandbox, and every handler writes production records, provisions real users, and sends real email. New partner accounts start with a test key, so create a live key before your first call.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://easy2257.com/api/v1/solo-accounts" \ -H "Content-Type: application/json" \ -d '{ "externalUserId": "user_12345", "email": "creator@example.com", "callbackUrl": "https://your-platform.com/webhooks/ez2257" }'{
"accountId": "cmd4k2x9p0001qz8h3v7ftg2a",
"status": "pending_id_verification",
"onboardingUrl": "https://easy2257.com/partner-onboard/9f2c...",
"createdAt": "2026-04-22T12:00:00Z"
}{
"accountId": "cmd4k2x9p0001qz8h3v7ftg2a",
"status": "pending_id_verification",
"onboardingUrl": "https://easy2257.com/partner-onboard/9f2c...",
"createdAt": "2026-04-22T12:00:00Z"
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}{
"error": "Too many requests. Please slow down.",
"retryAfter": 14,
"limit": 60,
"remaining": 0,
"reset": 1714000060000
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}