How to update a participant's location

Use this guide when you need to update a participant's country, region, and/or city.

Prerequisites

Your API key
The participant's internal id, external_id, or email
The country as a 2-letter ISO 3166-1 alpha-2 code (e.g. DE) or full name (e.g. Germany)

Request — country only

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "id=12345" \
  -F "country=DE"

Request — country, region, and city

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "id=12345" \
  -F "country=DE" \
  -F "region=Bavaria" \
  -F "city=Munich"

Response

JSON

{
  "code": 200,
  "errors": null,
  "data": {
    "id": 12345,
    "email": "john.doe@example.com",
    "status": "updated",
    "external_id": null,
    "info": ["Account match: id"],
    "errors": []
  },
  "response_id": "1700000000.12345"
}

Important rules

region requires country to be set in the same request. If you only pass region without country, it will be ignored
city requires country to be set in the same request, and must not exceed 80 characters
Country and city values are resolved against the platform's location database. Unrecognised values are recorded as non-fatal errors in the errors array — the account is still updated
Always check the errors array to confirm location fields were processed correctly