Partner registers a new eToro user

curl --request POST \
  --url https://public-api.etoro.com/api/v1/registration/users \
  --header 'Content-Type: application/json' \
  --header 'X-Request-Id: <x-request-id>' \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "countryIso": "GB",
  "consents": [
    {
      "signedAt": "2026-05-27T12:00:00Z",
      "documentId": 42,
      "clientIp": "1.2.3.4"
    }
  ],
  "languageIso": "en-gb",
  "username": "partneruser01",
  "email": "user@example.com",
  "partnerCorrelationId": "partner-ref-001"
}
'

import requests

url = "https://public-api.etoro.com/api/v1/registration/users"

payload = {
    "countryIso": "GB",
    "consents": [
        {
            "signedAt": "2026-05-27T12:00:00Z",
            "documentId": 42,
            "clientIp": "1.2.3.4"
        }
    ],
    "languageIso": "en-gb",
    "username": "partneruser01",
    "email": "user@example.com",
    "partnerCorrelationId": "partner-ref-001"
}
headers = {
    "X-Request-Id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Request-Id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    countryIso: 'GB',
    consents: [{signedAt: '2026-05-27T12:00:00Z', documentId: 42, clientIp: '1.2.3.4'}],
    languageIso: 'en-gb',
    username: 'partneruser01',
    email: 'user@example.com',
    partnerCorrelationId: 'partner-ref-001'
  })
};

fetch('https://public-api.etoro.com/api/v1/registration/users', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/registration/users",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'countryIso' => 'GB',
    'consents' => [
        [
                'signedAt' => '2026-05-27T12:00:00Z',
                'documentId' => 42,
                'clientIp' => '1.2.3.4'
        ]
    ],
    'languageIso' => 'en-gb',
    'username' => 'partneruser01',
    'email' => 'user@example.com',
    'partnerCorrelationId' => 'partner-ref-001'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Request-Id: <x-request-id>",
    "x-api-key: <api-key>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/registration/users"

	payload := strings.NewReader("{\n  \"countryIso\": \"GB\",\n  \"consents\": [\n    {\n      \"signedAt\": \"2026-05-27T12:00:00Z\",\n      \"documentId\": 42,\n      \"clientIp\": \"1.2.3.4\"\n    }\n  ],\n  \"languageIso\": \"en-gb\",\n  \"username\": \"partneruser01\",\n  \"email\": \"user@example.com\",\n  \"partnerCorrelationId\": \"partner-ref-001\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Request-Id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/registration/users")
  .header("X-Request-Id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"countryIso\": \"GB\",\n  \"consents\": [\n    {\n      \"signedAt\": \"2026-05-27T12:00:00Z\",\n      \"documentId\": 42,\n      \"clientIp\": \"1.2.3.4\"\n    }\n  ],\n  \"languageIso\": \"en-gb\",\n  \"username\": \"partneruser01\",\n  \"email\": \"user@example.com\",\n  \"partnerCorrelationId\": \"partner-ref-001\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/registration/users")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Request-Id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"countryIso\": \"GB\",\n  \"consents\": [\n    {\n      \"signedAt\": \"2026-05-27T12:00:00Z\",\n      \"documentId\": 42,\n      \"clientIp\": \"1.2.3.4\"\n    }\n  ],\n  \"languageIso\": \"en-gb\",\n  \"username\": \"partneruser01\",\n  \"email\": \"user@example.com\",\n  \"partnerCorrelationId\": \"partner-ref-001\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "username": "partneruser01",
    "loginSucceeded": true,
    "partnerCorrelationId": "partner-ref-001",
    "loginInfo": {}
  }
}

Registration

Partner registers a new eToro user

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

Registers a user on behalf of the partner. No password is supplied; eToro generates one. The synchronous response includes a user-scoped token bundle (access token, plus an ID token for the registration flow) issued by sts-idp with claims scoped by the SSO client_id resolved from X-ClientId, so the partner can chain the rest of the flow without an interactive login.

POST

api

registration

users

Partner registers a new eToro user

curl --request POST \
  --url https://public-api.etoro.com/api/v1/registration/users \
  --header 'Content-Type: application/json' \
  --header 'X-Request-Id: <x-request-id>' \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "countryIso": "GB",
  "consents": [
    {
      "signedAt": "2026-05-27T12:00:00Z",
      "documentId": 42,
      "clientIp": "1.2.3.4"
    }
  ],
  "languageIso": "en-gb",
  "username": "partneruser01",
  "email": "user@example.com",
  "partnerCorrelationId": "partner-ref-001"
}
'

import requests

url = "https://public-api.etoro.com/api/v1/registration/users"

payload = {
    "countryIso": "GB",
    "consents": [
        {
            "signedAt": "2026-05-27T12:00:00Z",
            "documentId": 42,
            "clientIp": "1.2.3.4"
        }
    ],
    "languageIso": "en-gb",
    "username": "partneruser01",
    "email": "user@example.com",
    "partnerCorrelationId": "partner-ref-001"
}
headers = {
    "X-Request-Id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Request-Id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    countryIso: 'GB',
    consents: [{signedAt: '2026-05-27T12:00:00Z', documentId: 42, clientIp: '1.2.3.4'}],
    languageIso: 'en-gb',
    username: 'partneruser01',
    email: 'user@example.com',
    partnerCorrelationId: 'partner-ref-001'
  })
};

fetch('https://public-api.etoro.com/api/v1/registration/users', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/registration/users",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'countryIso' => 'GB',
    'consents' => [
        [
                'signedAt' => '2026-05-27T12:00:00Z',
                'documentId' => 42,
                'clientIp' => '1.2.3.4'
        ]
    ],
    'languageIso' => 'en-gb',
    'username' => 'partneruser01',
    'email' => 'user@example.com',
    'partnerCorrelationId' => 'partner-ref-001'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Request-Id: <x-request-id>",
    "x-api-key: <api-key>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/registration/users"

	payload := strings.NewReader("{\n  \"countryIso\": \"GB\",\n  \"consents\": [\n    {\n      \"signedAt\": \"2026-05-27T12:00:00Z\",\n      \"documentId\": 42,\n      \"clientIp\": \"1.2.3.4\"\n    }\n  ],\n  \"languageIso\": \"en-gb\",\n  \"username\": \"partneruser01\",\n  \"email\": \"user@example.com\",\n  \"partnerCorrelationId\": \"partner-ref-001\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Request-Id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/registration/users")
  .header("X-Request-Id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"countryIso\": \"GB\",\n  \"consents\": [\n    {\n      \"signedAt\": \"2026-05-27T12:00:00Z\",\n      \"documentId\": 42,\n      \"clientIp\": \"1.2.3.4\"\n    }\n  ],\n  \"languageIso\": \"en-gb\",\n  \"username\": \"partneruser01\",\n  \"email\": \"user@example.com\",\n  \"partnerCorrelationId\": \"partner-ref-001\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/registration/users")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Request-Id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"countryIso\": \"GB\",\n  \"consents\": [\n    {\n      \"signedAt\": \"2026-05-27T12:00:00Z\",\n      \"documentId\": 42,\n      \"clientIp\": \"1.2.3.4\"\n    }\n  ],\n  \"languageIso\": \"en-gb\",\n  \"username\": \"partneruser01\",\n  \"email\": \"user@example.com\",\n  \"partnerCorrelationId\": \"partner-ref-001\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "username": "partneruser01",
    "loginSucceeded": true,
    "partnerCorrelationId": "partner-ref-001",
    "loginInfo": {}
  }
}

Authorizations

x-api-key

string

header

default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

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

default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

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_

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.

Show child attributes

username

string

required

Desired username for the new account (4-20 characters).

Required string length: 4 - 20

Example:

"partneruser01"

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"

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.

Show child attributes

⌘I

Getting started

Partners API

Changelog

Partner registers a new eToro user

Authorizations

Headers

Body

Response