curl --request POST \
--url https://api.zuddl.com/v1/events/{eventId}/attendees \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"eventId": "d812a64f-8865-4289-9024-9a120792c3d8",
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@zuddl.com",
"bio": "<string>",
"company": "<string>",
"country": "United States",
"designation": "<string>",
"phoneNumber": {
"code": "+1",
"number": "2125551234"
},
"customFieldsData": [
{
"fieldSlug": "city1",
"value": "New York City"
},
{
"fieldSlug": "age",
"value": 30
},
{
"fieldSlug": "interests",
"value": "Reading, Music, Travel"
},
{
"fieldSlug": "birthDate",
"value": "2001-06-27"
},
{
"fieldSlug": "country",
"value": "United States"
}
],
"disclaimers": [
{
"id": "66a2a042-afcf-4535-823e-65ea80deb6a9",
"consentGiven": "true"
}
],
"flowId": "814d4453-16e2-45cb-814a-7baf152c4f3b",
"ticketDetails": {
"ticketTypeId": "cce22fae-3536-4b28-b927-bec560dd4c37"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/zuddl",
"twitter": "https://x.com/wearezuddl",
"instagram": "https://www.instagram.com/wearezuddl",
"facebook": "https://facebook.com/zuddl",
"website": "https://www.zuddl.com"
},
"sendRegistrationConfirmationEmail": true
}'
{
"kind": "<string>",
"url": "<string>",
"id": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
"eventId": "d812a64f-8865-4289-9024-9a120792c3d8",
"profile": {
"firstName": "Jane",
"lastName": "Smith",
"email": "jane.smith@example.com",
"company": "Zuddl",
"designation": "Senior Software Engineer",
"bio": "Jane is a senior engineer with over 10 years of experience in cloud architecture.",
"headline": "Cloud Architecture Expert | Tech Speaker",
"industry": "Information Technology",
"country": "United States",
"phoneNumber": "+1-2125551234",
"profilePictureUrl": "https://cdn.zuddl.com/attendees/atnd_12345abcde/profile.jpg"
},
"customFieldsData": [
{
"fieldSlug": "city1",
"value": "New York City"
}
],
"disclaimers": [
{
"text": "<p>I agree to the terms and conditions</p>",
"consentGiven": true
}
],
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/zuddl",
"twitter": "https://x.com/wearezuddl",
"instagram": "https://www.instagram.com/wearezuddl",
"facebook": "https://facebook.com/zuddl",
"website": "https://www.zuddl.com"
},
"ticketDetails": {
"ticketTypeId": "f6b8cf1f-64e5-4801-935c-f6398bb111cd",
"ticketName": "VIP Pass",
"promoCode": "SPRING2025",
"addOns": [
{
"id": "67f6ccf5-4c3d-4fed-bcca-822e3c3cf25a",
"name": "Advanced Workshop",
"sessions": [
{
"id": "0b838477-24bf-46a7-a9bd-c40bfa2b2c53",
"name": "Session name"
}
]
}
]
},
"qrCodeImgUrl": "https://cdn.zuddl.com/qrcodes/atnd_12345abcde.png",
"confirmationCode": "01U6K9",
"status": "REGISTERED",
"statusUpdatedAt": "2025-04-07T09:57:55.71874Z",
"statusSource": "MANUAL_UPDATE",
"source": {
"type": "ZUDDL_API",
"referrer": "https://site.zuddl.com/landing-page",
"utmParams": {
"id": "123456",
"source": "newsletter",
"medium": "email",
"campaign": "march_promo",
"term": "newsletter",
"content": "newsletter"
},
"metadata": {
"key": "value"
}
},
"roles": [
"ATTENDEE",
"SPEAKER"
],
"unsubscribedNotificationDetails": [
{
"unsubscribeReason": "unsubscribeReasonExample",
"categoryName": "PROMOTIONAL"
}
],
"createdAt": "2025-04-07T09:57:55.826749Z",
"createdBy": "a412e3d2-e15e-4fe0-bf35-7fcfb235a4b2",
"updatedAt": "2025-04-07T09:57:56.045946Z"
}
This API endpoint adds an attendee by passing the required registration details in the request payload. The attendee must be associated with a registration flow. If it is a ticketed event, the attendee must also be associated with a ticket as well. A unique registrationId is created that identifies the particular attendee.
Required API key scopes: WRITE
This API can only be called with an access key that was generated for Backend usage.
curl --request POST \
--url https://api.zuddl.com/v1/events/{eventId}/attendees \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"eventId": "d812a64f-8865-4289-9024-9a120792c3d8",
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@zuddl.com",
"bio": "<string>",
"company": "<string>",
"country": "United States",
"designation": "<string>",
"phoneNumber": {
"code": "+1",
"number": "2125551234"
},
"customFieldsData": [
{
"fieldSlug": "city1",
"value": "New York City"
},
{
"fieldSlug": "age",
"value": 30
},
{
"fieldSlug": "interests",
"value": "Reading, Music, Travel"
},
{
"fieldSlug": "birthDate",
"value": "2001-06-27"
},
{
"fieldSlug": "country",
"value": "United States"
}
],
"disclaimers": [
{
"id": "66a2a042-afcf-4535-823e-65ea80deb6a9",
"consentGiven": "true"
}
],
"flowId": "814d4453-16e2-45cb-814a-7baf152c4f3b",
"ticketDetails": {
"ticketTypeId": "cce22fae-3536-4b28-b927-bec560dd4c37"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/zuddl",
"twitter": "https://x.com/wearezuddl",
"instagram": "https://www.instagram.com/wearezuddl",
"facebook": "https://facebook.com/zuddl",
"website": "https://www.zuddl.com"
},
"sendRegistrationConfirmationEmail": true
}'
{
"kind": "<string>",
"url": "<string>",
"id": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
"eventId": "d812a64f-8865-4289-9024-9a120792c3d8",
"profile": {
"firstName": "Jane",
"lastName": "Smith",
"email": "jane.smith@example.com",
"company": "Zuddl",
"designation": "Senior Software Engineer",
"bio": "Jane is a senior engineer with over 10 years of experience in cloud architecture.",
"headline": "Cloud Architecture Expert | Tech Speaker",
"industry": "Information Technology",
"country": "United States",
"phoneNumber": "+1-2125551234",
"profilePictureUrl": "https://cdn.zuddl.com/attendees/atnd_12345abcde/profile.jpg"
},
"customFieldsData": [
{
"fieldSlug": "city1",
"value": "New York City"
}
],
"disclaimers": [
{
"text": "<p>I agree to the terms and conditions</p>",
"consentGiven": true
}
],
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/zuddl",
"twitter": "https://x.com/wearezuddl",
"instagram": "https://www.instagram.com/wearezuddl",
"facebook": "https://facebook.com/zuddl",
"website": "https://www.zuddl.com"
},
"ticketDetails": {
"ticketTypeId": "f6b8cf1f-64e5-4801-935c-f6398bb111cd",
"ticketName": "VIP Pass",
"promoCode": "SPRING2025",
"addOns": [
{
"id": "67f6ccf5-4c3d-4fed-bcca-822e3c3cf25a",
"name": "Advanced Workshop",
"sessions": [
{
"id": "0b838477-24bf-46a7-a9bd-c40bfa2b2c53",
"name": "Session name"
}
]
}
]
},
"qrCodeImgUrl": "https://cdn.zuddl.com/qrcodes/atnd_12345abcde.png",
"confirmationCode": "01U6K9",
"status": "REGISTERED",
"statusUpdatedAt": "2025-04-07T09:57:55.71874Z",
"statusSource": "MANUAL_UPDATE",
"source": {
"type": "ZUDDL_API",
"referrer": "https://site.zuddl.com/landing-page",
"utmParams": {
"id": "123456",
"source": "newsletter",
"medium": "email",
"campaign": "march_promo",
"term": "newsletter",
"content": "newsletter"
},
"metadata": {
"key": "value"
}
},
"roles": [
"ATTENDEE",
"SPEAKER"
],
"unsubscribedNotificationDetails": [
{
"unsubscribeReason": "unsubscribeReasonExample",
"categoryName": "PROMOTIONAL"
}
],
"createdAt": "2025-04-07T09:57:55.826749Z",
"createdBy": "a412e3d2-e15e-4fe0-bf35-7fcfb235a4b2",
"updatedAt": "2025-04-07T09:57:56.045946Z"
}
Provide your API key secret in the Authorization
header
Unique identifier of the event
Registered attendee successfully
The response is of type object
.
Was this page helpful?