Create account
Create a SideShift Connect account for one of your users.
If the same externalId has already been created under your integration, the existing account is returned even if a different email is supplied. Use a stable internal user ID here to prevent one creator with multiple emails from becoming multiple payable Connect accounts.
If the email already exists under your integration, the existing account is returned (idempotent). When the email belongs to a different SideShift user, enableFallbacks defaults to true and SideShift tries provider +alias and SideShift-managed fallback emails. New account creation does not link the pre-existing user.
Fallbacks are also attempted when payment-account provisioning for the original email returns a classified email collision/validation error or suspended-account error. A suspended-account fallback creates a separate managed account; it does not restore, merge, or change the suspended payment-provider account. Unrelated provider failures are not treated as suspended/email fallback signals.
A fallback run examines at most 100 numbered fallback slots and stops after 3 counted fallback payment-account provisioning failures. Each slot considers a provider +alias first. Its deterministic SideShift-managed address is considered when that alias is occupied or its provisioning failure qualifies for the managed-address retry. Occupied candidates are skipped. No usable candidate within the slot boundary returns 409 EMAIL_ALREADY_EXISTS; the provisioning stop returns 500 PAYMENT_ACC_CREATION_FAILED.
Use a stable externalId and retry the same request after a timeout or retryable server failure. A completed account is returned rather than duplicated. Store the returned sideshiftAccountId and resolved email; emailModified and originalEmail describe a fallback response, but are optional on later idempotent lookups.
Set enableFallbacks: false to opt out. A foreign SideShift email then returns 404, and a payment-account provisioning failure returns 500 without trying alternate emails.
Sandbox: The returned paymentAccountId is prefixed with sim_biz_ and no real payment account is provisioned.
Authorizations
Your SideShift Connect API key (sk_live_* or sk_test_*). Generate from Settings → Connect.
Body
User's email address
"jane@example.com"
Display name (max 100 characters)
"Jane Creator"
Your platform's stable internal user ID. SideShift checks it within your integration before email lookup and returns the existing account when found. Do not send concurrent create requests for the same value.
"usr_123"
Profile image URL
When true (default), try provider +alias and SideShift-managed fallback emails on email collision, classified email validation/collision failures, or a payment-provider suspended-account response. Set to false to disable alternate-email provisioning.
Display-only balance in cents (does not add real funds)
x >= 0