Skip to content

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 URLYours to choose. We recommend one per organiser account, for example https://api.yourplatform.example/innercrowd/{organiserId}. The organiser enters it in Innercrowd.
AuthenticationA bearer API key per organiser account, created in your back office.
FormatJSON over HTTPS.
OpenAPIThe OpenAPI 3.1 document follows with the API reference.
StatusDraft. The structure may still change before v1.

How it works ​

  1. 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.

  2. 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.

  3. Discovery · Calls to you

    GET /v1/account tells us whose account it is and which capabilities you support. We test each of them against the contract before the organiser can connect.

  4. 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.
  5. Disconnect · Innercrowd

    We stop calling you, and remove anything we registered. The organiser can revoke the key in your back office.