Skip to main content

Authorization

Follow this guide to create a new Humanitix credential that will allow Nexla to authenticate to and exchange data with your Humanitix account.
humanitix_api_auth.png

Humanitix

Prerequisites​

To connect Nexla to Humanitix, you will need a Humanitix account with at least one event and an API key generated from your account settings. Humanitix uses API key authentication — all requests are authenticated by including your API key in the x-api-key request header.

Obtain a Humanitix API Key​

  1. Sign in to your Humanitix account at console.humanitix.com.

  2. Click your account name or profile icon in the top menu bar to open the account menu.

  3. Navigate to Account > Advanced > Public API Key.

  4. Click Generate to create a new API key, or copy your existing API key from the field displayed on the page.

Important

Generating a new API key will immediately invalidate any previously issued API key. Any existing integrations using the old key will stop working and will need to be updated with the new key. Copy and store the key in a secure location before leaving this page.

  1. Keep your API key secure and do not share it with others. Your API key provides read access to all event, order, ticket, and tag data in your Humanitix account.

Additional details about the Humanitix Public API are available in the Humanitix Public API documentation and the interactive API reference on Stoplight.

Create a Humanitix Credential​

  • To create a new Humanitix credential, after selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key​

  1. Enter your Humanitix API key in the API Key field. This key authenticates Nexla with the Humanitix API and is included automatically as the x-api-key header in all API requests. The key must be kept confidential, as it provides access to your account's event and attendee data.

    All requests to the Humanitix API must be made over HTTPS. Nexla handles this requirement automatically when using a configured credential.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source creation and can be selected for use with a new data source.