Add an attendee
curl --request POST \
--url https://api.zuddl.com/v1/events/{eventId}/attendees \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@zuddl.com",
"bio": "<string>",
"company": "<string>",
"country": "United States",
"designation": "<string>",
"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",
"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
}
'import requests
url = "https://api.zuddl.com/v1/events/{eventId}/attendees"
payload = {
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@zuddl.com",
"bio": "<string>",
"company": "<string>",
"country": "United States",
"designation": "<string>",
"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",
"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
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: 'John',
lastName: 'Doe',
email: 'johndoe@zuddl.com',
bio: '<string>',
company: '<string>',
country: 'United States',
designation: '<string>',
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',
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
})
};
fetch('https://api.zuddl.com/v1/events/{eventId}/attendees', 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://api.zuddl.com/v1/events/{eventId}/attendees",
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([
'firstName' => 'John',
'lastName' => 'Doe',
'email' => 'johndoe@zuddl.com',
'bio' => '<string>',
'company' => '<string>',
'country' => 'United States',
'designation' => '<string>',
'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',
'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
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$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://api.zuddl.com/v1/events/{eventId}/attendees"
payload := strings.NewReader("{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"johndoe@zuddl.com\",\n \"bio\": \"<string>\",\n \"company\": \"<string>\",\n \"country\": \"United States\",\n \"designation\": \"<string>\",\n \"customFieldsData\": [\n {\n \"fieldSlug\": \"city1\",\n \"value\": \"New York City\"\n },\n {\n \"fieldSlug\": \"age\",\n \"value\": 30\n },\n {\n \"fieldSlug\": \"interests\",\n \"value\": \"Reading, Music, Travel\"\n },\n {\n \"fieldSlug\": \"birthDate\",\n \"value\": \"2001-06-27\"\n },\n {\n \"fieldSlug\": \"country\",\n \"value\": \"United States\"\n }\n ],\n \"disclaimers\": [\n {\n \"id\": \"66a2a042-afcf-4535-823e-65ea80deb6a9\",\n \"consentGiven\": \"true\"\n }\n ],\n \"flowId\": \"814d4453-16e2-45cb-814a-7baf152c4f3b\",\n \"socialLinks\": {\n \"linkedin\": \"https://www.linkedin.com/company/zuddl\",\n \"twitter\": \"https://x.com/wearezuddl\",\n \"instagram\": \"https://www.instagram.com/wearezuddl\",\n \"facebook\": \"https://facebook.com/zuddl\",\n \"website\": \"https://www.zuddl.com\"\n },\n \"sendRegistrationConfirmationEmail\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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://api.zuddl.com/v1/events/{eventId}/attendees")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"johndoe@zuddl.com\",\n \"bio\": \"<string>\",\n \"company\": \"<string>\",\n \"country\": \"United States\",\n \"designation\": \"<string>\",\n \"customFieldsData\": [\n {\n \"fieldSlug\": \"city1\",\n \"value\": \"New York City\"\n },\n {\n \"fieldSlug\": \"age\",\n \"value\": 30\n },\n {\n \"fieldSlug\": \"interests\",\n \"value\": \"Reading, Music, Travel\"\n },\n {\n \"fieldSlug\": \"birthDate\",\n \"value\": \"2001-06-27\"\n },\n {\n \"fieldSlug\": \"country\",\n \"value\": \"United States\"\n }\n ],\n \"disclaimers\": [\n {\n \"id\": \"66a2a042-afcf-4535-823e-65ea80deb6a9\",\n \"consentGiven\": \"true\"\n }\n ],\n \"flowId\": \"814d4453-16e2-45cb-814a-7baf152c4f3b\",\n \"socialLinks\": {\n \"linkedin\": \"https://www.linkedin.com/company/zuddl\",\n \"twitter\": \"https://x.com/wearezuddl\",\n \"instagram\": \"https://www.instagram.com/wearezuddl\",\n \"facebook\": \"https://facebook.com/zuddl\",\n \"website\": \"https://www.zuddl.com\"\n },\n \"sendRegistrationConfirmationEmail\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zuddl.com/v1/events/{eventId}/attendees")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"johndoe@zuddl.com\",\n \"bio\": \"<string>\",\n \"company\": \"<string>\",\n \"country\": \"United States\",\n \"designation\": \"<string>\",\n \"customFieldsData\": [\n {\n \"fieldSlug\": \"city1\",\n \"value\": \"New York City\"\n },\n {\n \"fieldSlug\": \"age\",\n \"value\": 30\n },\n {\n \"fieldSlug\": \"interests\",\n \"value\": \"Reading, Music, Travel\"\n },\n {\n \"fieldSlug\": \"birthDate\",\n \"value\": \"2001-06-27\"\n },\n {\n \"fieldSlug\": \"country\",\n \"value\": \"United States\"\n }\n ],\n \"disclaimers\": [\n {\n \"id\": \"66a2a042-afcf-4535-823e-65ea80deb6a9\",\n \"consentGiven\": \"true\"\n }\n ],\n \"flowId\": \"814d4453-16e2-45cb-814a-7baf152c4f3b\",\n \"socialLinks\": {\n \"linkedin\": \"https://www.linkedin.com/company/zuddl\",\n \"twitter\": \"https://x.com/wearezuddl\",\n \"instagram\": \"https://www.instagram.com/wearezuddl\",\n \"facebook\": \"https://facebook.com/zuddl\",\n \"website\": \"https://www.zuddl.com\"\n },\n \"sendRegistrationConfirmationEmail\": true\n}"
response = http.request(request)
puts response.read_body{
"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": [
{
"id": "f6b8cf1f-64e5-4801-935c-f6398bb111cd",
"slug": "termsConsent",
"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"
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"errors": {}
}Attendees
Add an attendee
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.
POST
/
v1
/
events
/
{eventId}
/
attendees
Add an attendee
curl --request POST \
--url https://api.zuddl.com/v1/events/{eventId}/attendees \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@zuddl.com",
"bio": "<string>",
"company": "<string>",
"country": "United States",
"designation": "<string>",
"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",
"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
}
'import requests
url = "https://api.zuddl.com/v1/events/{eventId}/attendees"
payload = {
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@zuddl.com",
"bio": "<string>",
"company": "<string>",
"country": "United States",
"designation": "<string>",
"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",
"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
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: 'John',
lastName: 'Doe',
email: 'johndoe@zuddl.com',
bio: '<string>',
company: '<string>',
country: 'United States',
designation: '<string>',
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',
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
})
};
fetch('https://api.zuddl.com/v1/events/{eventId}/attendees', 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://api.zuddl.com/v1/events/{eventId}/attendees",
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([
'firstName' => 'John',
'lastName' => 'Doe',
'email' => 'johndoe@zuddl.com',
'bio' => '<string>',
'company' => '<string>',
'country' => 'United States',
'designation' => '<string>',
'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',
'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
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$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://api.zuddl.com/v1/events/{eventId}/attendees"
payload := strings.NewReader("{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"johndoe@zuddl.com\",\n \"bio\": \"<string>\",\n \"company\": \"<string>\",\n \"country\": \"United States\",\n \"designation\": \"<string>\",\n \"customFieldsData\": [\n {\n \"fieldSlug\": \"city1\",\n \"value\": \"New York City\"\n },\n {\n \"fieldSlug\": \"age\",\n \"value\": 30\n },\n {\n \"fieldSlug\": \"interests\",\n \"value\": \"Reading, Music, Travel\"\n },\n {\n \"fieldSlug\": \"birthDate\",\n \"value\": \"2001-06-27\"\n },\n {\n \"fieldSlug\": \"country\",\n \"value\": \"United States\"\n }\n ],\n \"disclaimers\": [\n {\n \"id\": \"66a2a042-afcf-4535-823e-65ea80deb6a9\",\n \"consentGiven\": \"true\"\n }\n ],\n \"flowId\": \"814d4453-16e2-45cb-814a-7baf152c4f3b\",\n \"socialLinks\": {\n \"linkedin\": \"https://www.linkedin.com/company/zuddl\",\n \"twitter\": \"https://x.com/wearezuddl\",\n \"instagram\": \"https://www.instagram.com/wearezuddl\",\n \"facebook\": \"https://facebook.com/zuddl\",\n \"website\": \"https://www.zuddl.com\"\n },\n \"sendRegistrationConfirmationEmail\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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://api.zuddl.com/v1/events/{eventId}/attendees")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"johndoe@zuddl.com\",\n \"bio\": \"<string>\",\n \"company\": \"<string>\",\n \"country\": \"United States\",\n \"designation\": \"<string>\",\n \"customFieldsData\": [\n {\n \"fieldSlug\": \"city1\",\n \"value\": \"New York City\"\n },\n {\n \"fieldSlug\": \"age\",\n \"value\": 30\n },\n {\n \"fieldSlug\": \"interests\",\n \"value\": \"Reading, Music, Travel\"\n },\n {\n \"fieldSlug\": \"birthDate\",\n \"value\": \"2001-06-27\"\n },\n {\n \"fieldSlug\": \"country\",\n \"value\": \"United States\"\n }\n ],\n \"disclaimers\": [\n {\n \"id\": \"66a2a042-afcf-4535-823e-65ea80deb6a9\",\n \"consentGiven\": \"true\"\n }\n ],\n \"flowId\": \"814d4453-16e2-45cb-814a-7baf152c4f3b\",\n \"socialLinks\": {\n \"linkedin\": \"https://www.linkedin.com/company/zuddl\",\n \"twitter\": \"https://x.com/wearezuddl\",\n \"instagram\": \"https://www.instagram.com/wearezuddl\",\n \"facebook\": \"https://facebook.com/zuddl\",\n \"website\": \"https://www.zuddl.com\"\n },\n \"sendRegistrationConfirmationEmail\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zuddl.com/v1/events/{eventId}/attendees")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"johndoe@zuddl.com\",\n \"bio\": \"<string>\",\n \"company\": \"<string>\",\n \"country\": \"United States\",\n \"designation\": \"<string>\",\n \"customFieldsData\": [\n {\n \"fieldSlug\": \"city1\",\n \"value\": \"New York City\"\n },\n {\n \"fieldSlug\": \"age\",\n \"value\": 30\n },\n {\n \"fieldSlug\": \"interests\",\n \"value\": \"Reading, Music, Travel\"\n },\n {\n \"fieldSlug\": \"birthDate\",\n \"value\": \"2001-06-27\"\n },\n {\n \"fieldSlug\": \"country\",\n \"value\": \"United States\"\n }\n ],\n \"disclaimers\": [\n {\n \"id\": \"66a2a042-afcf-4535-823e-65ea80deb6a9\",\n \"consentGiven\": \"true\"\n }\n ],\n \"flowId\": \"814d4453-16e2-45cb-814a-7baf152c4f3b\",\n \"socialLinks\": {\n \"linkedin\": \"https://www.linkedin.com/company/zuddl\",\n \"twitter\": \"https://x.com/wearezuddl\",\n \"instagram\": \"https://www.instagram.com/wearezuddl\",\n \"facebook\": \"https://facebook.com/zuddl\",\n \"website\": \"https://www.zuddl.com\"\n },\n \"sendRegistrationConfirmationEmail\": true\n}"
response = http.request(request)
puts response.read_body{
"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": [
{
"id": "f6b8cf1f-64e5-4801-935c-f6398bb111cd",
"slug": "termsConsent",
"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"
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"errors": {}
}Authorizations
Provide your API key secret in the Authorization header
Path Parameters
Unique identifier of the event
Pattern:
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Body
application/json
First name of the attendee
Maximum string length:
150Example:
"John"
Last name of the attendee
Maximum string length:
150Example:
"Doe"
Email address of the attendee
Maximum string length:
150Example:
"johndoe@zuddl.com"
Short biography of the attendee.
Maximum string length:
3000Company of the attendee
Maximum string length:
255Country of the attendee
Maximum string length:
255Example:
"United States"
Designation of the attendee
Maximum string length:
255Phone number of the attendee
Show child attributes
Show child attributes
Custom registration fields and their values. Each object must include a 'fieldSlug' and a corresponding 'value'.
- For dropdown (single-select) fields, provide one option as a simple string (e.g., "value": "Option1").
- For multiselect fields, provide comma-separated values (e.g., "value": "Option1, Option2").
→ In both dropdown and multiselect, the provided values must match the defined options. - For date fields, use the format 'YYYY-MM-DD'.
- For number fields, provide numeric values (e.g., age).
- For all other supported field types, provide a simple string in the 'value'.
Show child attributes
Show child attributes
Example:
[
{
"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 of the registration
Show child attributes
Show child attributes
Example:
[
{
"id": "66a2a042-afcf-4535-823e-65ea80deb6a9",
"consentGiven": "true"
}
]
The unique identifier of the registration flow for the attendee.
Example:
"814d4453-16e2-45cb-814a-7baf152c4f3b"
Ticket details for the attendee
Show child attributes
Show child attributes
Social media links of the attendee
Show child attributes
Show child attributes
A boolean that specifies whether a registration confirmation email is to be sent to the attendee.
Available options:
true, false Example:
true
Response
Registered attendee successfully
Unique Identifier of the event registration for the attendee
Example:
"d5e31ba5-2d1e-4918-bb60-dd1514b4b397"
Unique identifier of the event for the attendee
Example:
"d812a64f-8865-4289-9024-9a120792c3d8"
Profile details of the attendee
Show child attributes
Show child attributes
Custom fields in the registration form
Show child attributes
Show child attributes
List of disclaimers
Show child attributes
Show child attributes
Social media links of the attendee
Show child attributes
Show child attributes
Ticket and other related details
Show child attributes
Show child attributes
URL of the attendee's QR code image
Example:
"https://cdn.zuddl.com/qrcodes/atnd_12345abcde.png"
Confirmation code for registration
Example:
"01U6K9"
Status of the attendee
Available options:
PENDING, REJECTED, REGISTERED, APPROVED_NOT_REGISTERED, INCOMPLETE, ATTENDED_VIRTUALLY, ATTENDED_IN_PERSON, ATTENDED_BOTH, NO_SHOW Example:
"REGISTERED"
Timestamp when the attendee’s status was updated
Example:
"2025-04-07T09:57:55.71874Z"
Source of the attendee's status
Available options:
MANUAL_UPDATE, SYSTEM_UPDATE Example:
"MANUAL_UPDATE"
Registration source details
Show child attributes
Show child attributes
Roles of this attendee
Roles of this attendee
Available options:
ATTENDEE, ORGANIZER, SPEAKER, SPONSOR, MODERATOR Example:
["ATTENDEE", "SPEAKER"]
List of unsubscribed notification categories
Show child attributes
Show child attributes
Example:
[
{
"unsubscribeReason": "unsubscribeReasonExample",
"categoryName": "PROMOTIONAL"
}
]
Creation timestamp
Example:
"2025-04-07T09:57:55.826749Z"
User ID of the creator
Example:
"a412e3d2-e15e-4fe0-bf35-7fcfb235a4b2"
Update timestamp
Example:
"2025-04-07T09:57:56.045946Z"
Was this page helpful?
⌘I