How to update a participant's basic info

How to update a participant's basic info

Use this guide when you need to update a participant's name, job title, or company name.


⚠️ These fields are global. Name, company, and job title exist at the environment level. Updating any of these fields for a participant in a specific event will trigger a cascade update in every other event this account is attached to within the same data environment.


What you'll need before starting

What you need

Where to get it

Participant ID, External ID, or email

GET /api/v2/account/get or GET /api/v2/participants/{eventId}/list


Request — update by internal ID

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 "first_name=Jonathan" \
  -F "last_name=Doe" \
  -F "job_title=Senior Product Manager" \
  -F "company_name=Acme Corp Ltd"

Request — update by email

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 "email=john.doe@example.com" \
  -F "job_title=Senior Product Manager" \
  -F "company_name=Acme Corp Ltd"

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"
}

Notes

  • Only include the fields you want to change — any field not included will remain unchanged

  • first_name and last_name can be updated at any time; email serves as the login identifier and should be updated with care