Register Participant API

Use this endpoint to programmatically register a user for an event. This is ideal for syncing users after they purchase a ticket on your own website (WooCommerce, Shopify, etc.).

Endpoint

POST /registrations

Headers

• Content-Type: application/json
• x-api-key: YOUR_API_SECRET

Getting Your IDs

To find the specific eventId and trackIds for your payload:

1. Go to Registration Forms.
2. Click Publish on the relevant form.
3. Switch to the API Integration tab to copy the IDs.

Request Body

{
  "eventId": "65a1b2c3d4e5f6g7h8i9j0k1",
  "email": "learner@example.com",
  "firstName": "Jane",
  "lastName": "Doe",
  "paymentStatus": "paid",
  "trackIds": [
    "65x9y8z7..."  // Optional: Specific track IDs to enroll in
  ],
  "profileFields": {
    "phoneNumber": "+1234567890",
    "jobTitle": "Senior Developer",
    "bio": "Excited to learn!"
  }
}

Behavior

• New Users: An account is created, and they receive a "Setup Password" email.
• Existing Users: They are simply enrolled in the new event/tracks without overwriting their existing profile data.
• Free Events: The paymentStatus is automatically set to free, ignoring the payload.

Response

Returns 200 OK on success.

{
  "success": true,
  "data": {
    "userId": "...",
    "isNewUser": true
  }
}