How do I get an API key and make my first request?

Create a key

1. Sign in as the owner of the workspace and open Organization settings from the account menu, then the tab API & webhooks.
2. Click Create key. Give it a name that says where it is used (Zapier, badge printer, CRM sync).
3. Pick the scopes. Read covers everything available today. Write and check-in are for the endpoints in the next release; you can tick them now so the key does not need replacing later.
4. Optionally set an expiry date. Save. The key is shown once; copy it and store it in your server's environment variables.

Your first request

curl https://www.guestlistonline.com/api/v1/me \
  -H "Authorization: Bearer glo_live_..."

The answer names your workspace, the key and its scopes. From there:

• GET /events lists your events with guest, attending and checked-in counts.
• GET /events/{id}/guests?status=attending lists the guests of one event; filter by tag, email or updated_since.
• Lists come in pages: pass next_cursor back as ?cursor= until it is null.

Keep the key safe

• A key sees only its own workspace, and only what its scopes allow. Still treat it like a password.
• Never put it in a browser page or a mobile app. The API refuses browser requests on purpose.
• Revoke a key the moment you suspect it leaked; the revocation is immediate. You can have up to 10 active keys, so use one per integration.

Limits and errors

120 requests per minute and 5,000 per hour per key. Every error has a stable code, for example rate_limited, insufficient_scope or plan_required, and a plain message. The Recent API requests list on the same settings tab shows what your integration did and which calls failed.