Skip to main content

Guide: External Integrations

Follow the steps below to create an Integration with an external API

Updated over 2 months ago

1. Create the Event you're configuring

a) Go the Events page and create a new Event

b) You only need to enter the details for the Info page to begin with - prices and Performances will be generated once the Integration is created (see below) so no need to create these once the Info page has been submitted

2. Create an External Integration

a) Either to the Tools page on the left hand side and click External Integrations

b) Or go to the Settings page on your Event and click External Integration

3. Enter details for Integration

a) Name - for internal use

b) Description

c) Event - if creating via the Tools page. This field can't be updated once the integration is created

d) External Event ID - the ID of this Event in the external system. Provided by Nliven or Audience View

4. Configure Pricing

a) Tax Rate - select either the Default Tax Rate or a Custom Tax Rate which you can create on the Settings page

b) Base Price Adjuster - optional. This is an Inside Adjuster that will be applied to all prices before other Adjusters, changing the price the other adjusters will be based on

c) Inside Adjusters - select the Adjusters that will be automatically applied to all prices on the external Event

d) Outside Adjusters - see above

5. Configure Integration Type - Nliven

If you are integrating with Audience View, skip to the next step.

a) Select Nliven from the dropdown

b) Enter API Key - provided by Audience View or the Nliven venue

c) API URL

d) Prefix - this will be attached to the front of the Transaction Reference for orders using the Nliven Integration

e) Delivery Method - optional, the ID provided by Nliven

f) Allow Email Sharing - select to enable the customer's email to be shared with Nliven

g) Enable Ticket Import - select to enable Nliven barcodes to be imported as external barcodes

h) Enable Seat Type Sync - select to enable Nliven Seat Types to be synced into Line-Up

i) Click Create

6. Configure Integration Type - Audience View

a) Select Audience View from the dropdown

b) Enter API Key - provided by Audience View or the AV venue

c) API URL

d) Prefix - will be used when creating resources, e.g. Seat Types

e) User ID

f) Password

g) Promo Code

h) Delivery Method ID - the ID provided by Audience View

i) Agent ID

j) Payment ID

k) Allow Email Sharing - select to enable the customer's email to be shared with Audience View

l) Enable Ticket Import - select to enable Audience View barcodes to be imported as external barcodes

m) Enable Seat Type Sync - select to enable Audience View Seat Types to be synced into Line-Up

n) Click Create

7. Create Venue Plan

a) On the Venues page, click the Venue Plans tab

b) Click New Venue Plan and enter details

c) Use the Builder to build your Venue Plan. NOTE - you'll need to match how these systems structure their Venue Plans, i.e. how the hierarchy is created - Areas, Sections, Rows, Seats, etc.

If you are integrating with Nliven, you also need to ensure that Section labels match what is on their system. You can name Area labels differently if you wish.

8. Manage Prices to begin the sync

a) Once the Integration is created for the Event, the Performances and Price Tables will be automatically generated

b) On the Performances page, add Channel access

c) On your Price Table(s), add the Channels to your Variants

d) Create a Price Profile on the Event and apply to Performances. NOTE - you can only do this once the Venue Plan is created (see step 7)

The proactive syncing will kick in once the Price Profiles get added.

Did this answer your question?