Quickstart

Quickstart

List a community's upcoming events: first with curl, then from your own server with the JavaScript client, then rendered with the React components.

Get a key and your community tag

In the community admin, open Integrations → API keys. Copy the publishable key (ck_…): it can read public data and is safe to use anywhere. Your community tag is the name in your community's address, for example your-community.

Reads like this one need only READ_PUBLIC. Signing members in, checkout and anything operator-side need a secret key, kept on your server. See API keys and scopes.

Make the call

export COBUNTU_KEY=ck_your_publishable_key
 
curl "https://api.cobuntu.com/api/v1/communities/your-community/events?upcoming=true&limit=3" \
  -H "X-API-Key: $COBUNTU_KEY"

Read the answer

{
  "events": [
    { "id": "evt_1", "slug": "supper-club", "name": "Supper club",
      "startDate": "2026-11-03T19:00:00Z", "tiers": [ ... ] }
  ],
  "hasMore": true,
  "nextCursor": "eyJ..."
}

Amounts are in cents, lists page with nextCursor, and errors are { error, code }. See Money and currency, Pagination and Errors.

Next steps