Appearance
Innercrowd Connect
Innercrowd Connect is an HTTP API that a ticketing platform implements once, so that every organiser on that platform can connect their account to Innercrowd with a base URL and an API key. Innercrowd calls your API. You only call ours if you send webhooks.
Innercrowd runs ambassador campaigns for organisers. It needs their events and orders to credit ambassadors for the sales made with their voucher codes, and to reach buyers and ticket holders. Optionally it creates those voucher codes in your platform.
| Base URL | Yours to choose. We recommend one per organiser account, for example https://api.yourplatform.example/innercrowd/{organiserId}. The organiser enters it in Innercrowd. |
| Authentication | A bearer API key per organiser account, created in your back office. |
| Format | JSON over HTTPS. |
| OpenAPI | The OpenAPI 3.1 document follows with the API reference. |
| Status | Draft. The structure may still change before v1. |
How it works
Create a key · Your back office
A key for their own account in your platform. It gives access to exactly that one organiser account, never to your whole platform.
Connect · Innercrowd
We recommend a base URL per organiser account, for example
https://api.yourplatform.example/innercrowd/{organiserId}, so you know whose data is asked for before you look at the key. Every path starts with its version, such as/v1/orders, so you can serve a future v2 of one capability next to v1.Discovery · Calls to you
GET /v1/accounttells us whose account it is and which capabilities you support. We test each of them against the contract before the organiser can connect.Capabilities · Calls to you
- Catalogue: we import your events once, then pick up changes about every hour.
- Orders: we import all orders once, then pick up changes as often as you allow.
- Webhooks: you tell us when an order changes, and we fetch it within seconds.
- Vouchers: we create and remove ambassador codes as campaigns and rewards run.
Disconnect · Innercrowd
We stop calling you, and remove anything we registered. The organiser can revoke the key in your back office.