Skip to main content
POST
Partner registers a new etoro user

Authorizations

x-api-key
string
header
required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key
string
header
required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Scopes

etoro-public:partner:registration:write

Grants access to the 'etoro-public:partner:registration:write' scope.

Headers

X-Request-Id
string<uuid>
required

Body

application/json

Request body for partner user registration.

countryIso
string
required

ISO 3166 country code (2-3 characters).

Required string length: 2 - 3
Example:

"GB"

consents
object[]
required

Regulation documents the user consented to.

email
string<email>
required

Email address for the new account (max 255 characters).

Maximum string length: 255
Example:

"user@example.com"

languageIso
string

BCP 47 locale code for the preferred language. Optional.

Example:

"en-gb"

username
string

Optional. Desired username for the new account. If omitted, etoro generates a username and returns it in data.username. Effective rules: 6-16 characters; letters, digits, underscore and hyphen only; leading and trailing spaces are trimmed; names of trading instruments are not allowed. Check a username first with POST /api/v1/registration/users/usernames/validate.

Required string length: 4 - 20
Example:

"partneruser01"

regionIsoCode
string

Optional sub-national region ISO code (e.g. US-TX for Texas).

Example:

"US-TX"

partnerCorrelationId
string

Partner-supplied correlation identifier (max 100 characters).

Maximum string length: 100
Example:

"partner-ref-001"

Response

User registered successfully. The loginSucceeded field indicates whether auto-login succeeded after registration.

Partner user registration response envelope.

success
boolean

Whether the registration succeeded.

Example:

true

data
object

Partner user registration result payload.