API Reference

Create Attendee

Add a new attendee to your organization.

POST/api/v1/attendees

Programmatically add a new attendee to the system. Phone numbers are automatically normalized, and duplicate checking is enforced on both `phone` and `external_id` (e.g., student IDs) to maintain database integrity.

Authorization

Bearer Token Required

Include your API key in the Authorization header as Bearer attg_live_…

Headers

Parameter	Type	Required	Description
`Authorization`	string	required	Bearer token. Format: `Bearer attg_live_…`

Body Parameters

Parameter	Type	Required	Description
`first_name`	string	required	Attendee's first name
`last_name`	string	required	Attendee's last name
`phone`	string	optional	Attendee's phone number
`external_id`	string	optional	Custom ID (e.g. Student ID)

Rate Limits

120 requests per 60s window per IP address.

Responses

Attendee created successfully.

{
  "ok": true,
  "data": {
    "id": "uuid",
    "first_name": "Ahmed"
  }
}

curl -X POST "https://attend-go.com/api/v1/attendees" \
  -H "Authorization: Bearer attg_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Ahmed", "last_name": "Ali", "phone": "+201234567890"}'

201Response

{
  "ok": true,
  "data": {
    "id": "uuid",
    "first_name": "Ahmed"
  }
}