API for developers

Connect Adsumio to your tools with a REST API under /api/v1, described in OpenAPI 3 and included in every plan.

Authentication

Create a personal token in the administration, under API tokens, then send it in the Authorization header. It is shown only once, and revoking it takes effect on the next request. The session cookie is not accepted.

curl -H "Authorization: Bearer $ADSUMIO_TOKEN" \
  https://adsumio.com/api/v1/o/my-organization/events

Choosing the organization

Add the prefix /api/v1/o/{organizationSlug} to your routes. A user who belongs to a single organization can omit it.

Route	Purpose	Permission
`GET /api/v1/me`	The token's user	Authenticated user
`GET /api/v1/organizations`	The user's organizations	Authenticated user
`GET /api/v1/organizations/{organizationSlug}`	One organization the user belongs to	Authenticated user
`GET /api/v1/events`	List events	`event.view`
`POST /api/v1/events`	Create a draft event	`event.create`
`GET /api/v1/events/{event}`	One event	`event.view`
`GET /api/v1/events/{event}/registrations`	Registrations	`registration.view`
`GET /api/v1/events/{event}/staff`	Staff attendance	`staff.attendance.view`
`GET /api/v1/events/{event}/attendance`	Attendee attendance	`registration.view`
`GET /api/v1/events/{event}/survey`	Survey results	`survey.results.view`

Lists and pagination

Lists accept page (default 1), per_page (default 20, maximum 100), sort, and direction (asc or desc). Events filter by status and sort by starts_at or title. Registrations filter by status and sort by created_at or email.

Create an event

Send a JSON object with title, startsAt, endsAt, timezone, and locale (en or fr), and optionally capacity, description, and location. The event is created as a draft.

curl -X POST -H "Authorization: Bearer $ADSUMIO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Forum 2027",
    "startsAt": "2027-03-12T09:00:00+01:00",
    "endsAt": "2027-03-12T18:00:00+01:00",
    "timezone": "Europe/Paris",
    "locale": "fr"
  }' \
  https://adsumio.com/api/v1/o/my-organization/events

Limits and errors

A token is limited to 120 requests per minute. All errors share one shape:

{"error": {"code": "invalid", "message": "...", "fields": {"title": ["..."]}}}

Possible codes: unauthorized, forbidden, not_found, organization_required, invalid, rate_limited, unavailable, server_error.

OpenAPI description

Import the description into your client or code generator.

Download openapi.yaml

Ready to simplify your next event?

Create your account in under a minute. No app to install, no credit card required.

Create my account Pricing