events[].ref | string | | Stable | Name for this gig inside the document. |
events[].external_id | string | | Stable | Stable identifier from the source system (e.g. operator’s gig ID). Strongly recommended — drives upsert vs insert on re-import. |
events[].project_ref | ref → projects[].ref | | Stable | The project that owns this gig. Without it the gig gets its own one-gig project. |
events[].affiliated_project_refs | list of refs → projects[].ref | | Stable | Other projects this gig is linked to without belonging to them. |
events[].department_ref | string | | Stable | The department this gig is staffed under: a departments[].ref in this document, or the name of a department the organization already has (ignoring case). A name that matches neither is a row error. When departments are not turned on for the organization the gig imports without one and the field is reported as skipped. Re-importing a gig without this field keeps its department. |
events[].title | string | Yes | Stable | Name of the event/gig (e.g. ‘Acme Corp Holiday Party’). |
events[].event_date | YYYY-MM-DD | | Stable | Required unless the gig is a TEMPLATE with template_timing. |
events[].end_date | YYYY-MM-DD | | Stable | Last calendar day of a multi-day gig. Omit for a one-day gig. |
events[].event_type | string | | Stable | Operator-defined category — Wedding, Corporate, Concert, Festival, etc. |
events[].start_time | date-time | | Stable | The gig’s start time: an RFC 3339 timestamp with an offset (2026-06-15T19:00:00-04:00) or a local date-time. A bare date is rejected. One-day gigs only; a multi-day gig puts its times on its days. |
events[].end_time | date-time | | Stable | The gig’s end time: an RFC 3339 timestamp with an offset (2026-06-15T19:00:00-04:00) or a local date-time. A bare date is rejected. One-day gigs only; a multi-day gig puts its times on its days. |
events[].timezone | string | | Stable | IANA zone for offset-less start/end walls (e.g. America/Chicago). Persisted on Event.timezone. |
events[].status | string | | Stable | ACTIVE | ARCHIVED | UNARCHIVED | DRAFT | TEMPLATE | COMPLETED | SETTLED | CANCELLED. Defaults to ACTIVE. |
events[].default_performance_fee | decimal | | Stable | Per-performer fee paid out by the event (numeric, e.g. 500.00). |
events[].currency | string | | Stable | ISO 4217 code; defaults to USD. |
events[].payment_terms | string | | Stable | Free-text e.g. ‘Net 30’, ‘On the day’, ‘COD’. |
events[].notes | string | | Stable | Notes visible to crew and clients. |
events[].admin_notes | string | | Stable | Internal-only notes. |
events[].location | string | | Stable | Full street address. Map here if there’s no separate venue column. |
events[].location_name | string | | Stable | Human-readable name of the room/space. |
events[].latitude | decimal | | Stable | Latitude. |
events[].longitude | decimal | | Stable | Longitude. |
events[].place_id | string | | Stable | Place ID. |
events[].venue_ref | ref → venues[].ref | | Stable | The gig’s venue. Use this or an inline venue object, not both. |
events[].venue.name | string | | Stable | Name of the venue. Use this when the source has a dedicated venue column. |
events[].venue.external_id | string | | Stable | Source-system identifier for this venue (e.g. CRM ID). Improves dedup. |
events[].venue.address | string | | Stable | Street address of the venue. |
events[].venue.city | string | | Stable | Venue city. |
events[].venue.state | string | | Stable | Venue state. |
events[].venue.postal_code | string | | Stable | Venue postal code. |
events[].venue.country | string | | Stable | Venue country. |
events[].venue.phone_number | phone | | Stable | Venue phone. |
events[].venue.website | string | | Stable | Venue website. |
events[].venue.notes | string | | Stable | Venue notes. |
events[].venue.latitude | decimal | | Stable | Venue latitude. |
events[].venue.longitude | decimal | | Stable | Venue longitude. |
events[].venue.place_id | string | | Stable | Venue place ID. |
events[].venue.photo_url | string | | Stable | A public http(s) image URL for the venue’s baseline photo. Only fills a venue that has no photo yet. |
events[].client_ref | ref → clients[].ref | | Stable | The gig’s client. Use this or an inline client object, not both. |
events[].client.name | string | | Stable | Client/buyer who books the event. |
events[].client.email | email | | Stable | Customer email. |
events[].client.phone | phone | | Stable | Customer phone. |
events[].client.external_id | string | | Stable | Customer external ID. |
events[].client.website | string | | Stable | Customer website. |
events[].client.notes | string | | Stable | Customer notes. |
events[].days[].date | YYYY-MM-DD | Yes | Stable | A calendar day of the gig, between event_date and end_date. |
events[].days[].phases | list of strings | | Stable | What happens that day: any of PREP | LOAD_IN | REHEARSAL | SHOW | LOAD_OUT | RETURN | TRAVEL | DARK. |
events[].days[].notes | string | | Stable | Day notes. |
events[].days[].run_of_show[].name | string | Yes | Stable | Cue. |
events[].days[].run_of_show[].start | string | | Stable | Local time on that day as HH:MM (24-hour), in the gig’s timezone. |
events[].days[].run_of_show[].end | string | | Stable | Local time on that day as HH:MM (24-hour). An end before the start runs past midnight. |
events[].days[].run_of_show[].days_later | integer 1–365 | | Stable | How many calendar days after the listed day this cue’s times fall, for a cue after midnight. Leave out for a cue on the listed day. |
events[].days[].run_of_show[].segment | string | | Stable | Name of the segment this cue belongs to. Places a cue without a start time in its segment; a cue with a start time is placed by its time when this is left out. |
events[].days[].run_of_show[].notes | string | | Stable | Cue notes. |
events[].days[].run_of_show[].act_ref | ref → acts[].ref | | Stable | The act performing this cue. |
events[].days[].run_of_show[].timing_mode | string | | Stable | How the cue is timed: CLOCK | SEGUE | ON_CUE. ON_CUE needs a timing_label. |
events[].days[].run_of_show[].timing_label | string | | Stable | Text shown in place of a clock time for an ON_CUE cue, for example Upon cue during dinner. Up to 120 characters. |
events[].days[].run_of_show[].duration_minutes | integer ≥ 0 | | Stable | Minimum length of the cue in minutes. |
events[].days[].run_of_show[].duration_max_minutes | integer 0–1440 | | Stable | Longest the cue may run in minutes. Must be at least duration_minutes. |
events[].days[].run_of_show[].tentative | boolean | | Stable | True when the cue is not yet confirmed. |
events[].days[].run_of_show[].playback_source | string | | Stable | Where the cue’s audio plays from: LIVE | TRACK | DS_IPAD | OTHER. |
events[].days[].run_of_show[].note_roles | list of strings | | Stable | Who the cue’s note is for: any of SOUND | BAND_LEADER | PLANNER | MUSICIANS. |
events[].days[].run_of_show[].instructions | string | | Stable | Instructions for the people performing or running the cue. Up to 4000 characters. |
events[].days[].run_of_show[].location | string | | Stable | Where the cue happens. A cue with no location takes its segment’s location. |
events[].days[].run_of_show[].ensemble | string | | Stable | The ensemble performing the cue, for example the band’s name and headcount. |
events[].days[].run_of_show[].speakers[].name | string | Yes | Stable | Who speaks during the cue, in order. |
events[].days[].run_of_show[].speakers[].relationship | string | | Stable | How the speaker is related to the event, for example Parent of the groom. |
events[].days[].run_of_show[].speakers[].minutes | integer 0–600 | | Stable | How long the speaker talks, in minutes. |
events[].days[].run_of_show[].labels | list of refs → labels[].ref | | Stable | Labels on the cue, by labels[].ref. Import adds them and never takes a label off. |
events[].days[].segments[].name | string | Yes | Stable | The segment’s name, for example Reception. A cue whose start falls inside the segment’s window is filed under it. |
events[].days[].segments[].start | string | | Stable | Local time on that day as HH:MM (24-hour), in the gig’s timezone. |
events[].days[].segments[].end | string | | Stable | Local time on that day as HH:MM (24-hour). An end before the start runs past midnight. |
events[].days[].segments[].days_later | integer 1–365 | | Stable | How many calendar days after the listed day this segment’s times fall. Leave out for a segment on the listed day. |
events[].days[].segments[].segment_kind | string | | Stable | What the segment is: any of CEREMONY | COCKTAILS | RECEPTION | DINNER | DANCING | AFTER_PARTY | OTHER | SOUND_CHECK | LOAD_IN | REHEARSAL | DOORS | SHOW | INTERMISSION | LOAD_OUT. |
events[].days[].segments[].booking_state | string | | Stable | Accepted and ignored: segments are no longer marked booked or not booked. Any of BOOKED | CONTEXT_ONLY. |
events[].days[].segments[].location | string | | Stable | Where the segment happens. A cue with no location of its own takes it. |
events[].days[].segments[].ensemble | string | | Stable | The ensemble that plays the segment, for example the band’s name. |
events[].days[].segments[].piece_count | integer 0–99 | | Stable | How many instrumentalists play the segment, from 0 to 99. |
events[].days[].segments[].vocal_count | integer 0–99 | | Stable | How many vocalists sing in the segment, from 0 to 99. |
events[].days[].segments[].gear_notes | string | | Stable | Accepted and ignored: gear lives in the gig’s Inventory tab, not on run of show segments. |
events[].shifts[].title | string | | Stable | What the shift is called, in the source’s own words. Shown on the staffing board and used to match an org position when no separate role column is mapped. |
events[].shifts[].position | string | | Stable | Role to resolve against this org’s positions. Defaults to the shift name. An unmatched role still creates the shift — it just arrives unassigned for someone to map. |
events[].shifts[].seats | integer ≥ 1 | | Stable | How many people this shift needs. Defaults to 1. |
events[].shifts[].call_start | date-time | | Stable | Start of the call window. This decides which days the shift covers — a separate day count is not used, because sources routinely bill 1.5 days for a single-day call. |
events[].shifts[].call_end | date-time | | Stable | End of the call window. Absent, or on the same day as the start, makes a one-day shift. |
events[].shifts[].fee | decimal | | Stable | Per-person rate for the shift. Blank inherits the position default. |
events[].shifts[].fee_type | string | | Stable | FIXED (a day rate) or HOURLY. Defaults to FIXED. One of FIXED, HOURLY. |
events[].shifts[].notes | string | | Stable | What the shift is for. |
events[].shifts[].external_id | string | | Stable | Identifier from the source system, so a shift can be traced back to its line. |
events[].shifts[].currency | string | | Stable | ISO 4217 code of the shift and day rates. Blank uses the gig’s currency. |
events[].shifts[].section | string | | Stable | The section of an org-specific position. When the org has more than one position with the shift role’s name, the one in this section is used. Import does not create a missing position: the shift arrives with its role unmapped, as any unmatched role does. Named crew on the shift take the same position. Export writes the section only when the org has more than one position whose name matches the same way import matches names. |
events[].shifts[].days[].date | YYYY-MM-DD | Yes | Stable | A working day of the shift. When a shift lists days, they decide which days it covers instead of the call window. |
events[].shifts[].days[].call_start | date-time | | Stable | Start of the call on that day. Blank inherits no time. |
events[].shifts[].days[].call_end | date-time | | Stable | End of the call on that day. |
events[].shifts[].days[].seats | integer ≥ 1 | | Stable | How many people that day needs. Blank uses the shift’s seats. |
events[].shifts[].days[].fee | decimal | | Stable | Per-person rate for that day. Blank uses the shift rate. |
events[].shifts[].crew[].first_name | string | | Stable | Crew first name. |
events[].shifts[].crew[].last_name | string | | Stable | Crew last name. |
events[].shifts[].crew[].email | email | | Stable | Crew email. |
events[].shifts[].crew[].phone_number | phone | | Stable | Crew phone. |
events[].shifts[].crew[].performance_fee | decimal | | Stable | Per-performer fee override (otherwise uses event default). |
events[].shifts[].crew[].fee_notes | string | | Stable | Member fee notes. |
events[].shifts[].crew[].call_order | integer ≥ 0 | | Stable | Member call order. |
events[].shifts[].crew[].notes | string | | Stable | Notes about this person’s booking on the shift. Kept on the person’s place on the shift. |
events[].shifts[].crew[].status | string | | Stable | PENDING or BOOKED. BOOKED is work the person already agreed to: they land accepted on a filled shift that is never sent. On an upcoming gig their unpaid crew payable is created the same way as for an offer accepted in the app. On a finished gig only a stated rate is recorded, as pay already made. PENDING lands them on a draft shift for someone to send. Blank is BOOKED when the gig is COMPLETED, SETTLED or ARCHIVED or its last day is before today in the gig’s time zone, else PENDING. A re-import moves a person from PENDING to BOOKED only while the shift is an unsent import and they have not answered; it never moves anyone back to PENDING. One of PENDING, BOOKED. |
events[].shifts[].crew[].rate | decimal | | Stable | This person’s rate on the shift, per day or per hour as rate_type says. Becomes their fee on the shift when it is paid the same way as the shift. |
events[].shifts[].crew[].rate_type | string | | Stable | FIXED (a day rate) or HOURLY. Blank uses the shift’s rate type. One of FIXED, HOURLY. |
events[].shifts[].crew[].day_rate | decimal | | Stable | This person’s rate per day on a FIXED shift. With it, rate is the whole booking and pay is capped at day_rate times the days they accept. Blank rate becomes day_rate times their booked days. Ignored on an HOURLY shift. |
events[].shifts[].crew[].days[].date | YYYY-MM-DD | Yes | Stable | A day this person works the shift. A person who lists no days works every day of the shift. A listed day the shift does not list is added to the shift. |
events[].shifts[].crew[].days[].call_start | date-time | | Stable | This person’s own call start that day. Blank uses the shift day’s call. |
events[].shifts[].crew[].days[].call_end | date-time | | Stable | This person’s own call end that day. An end after midnight stays on the day it started. |
events[].shifts[].crew[].days[].notes | string | | Stable | Notes about this person’s work that day. |
events[].pack_items[].name | string | | Stable | Inventory item to pack for the gig, matched by name when no gear external ID is mapped. An item not in inventory yet is added to it. |
events[].pack_items[].external_id | string | | Stable | The inventory item external ID (spreadsheet id or Soundcheck record id), matched before the name. |
events[].pack_items[].quantity | integer ≥ 1 | | Stable | How many units pack out for the gig. Defaults to 1. |
events[].pack_items[].notes | string | | Stable | Packing note for this line. |
events[].guest_count | integer ≥ 0 | | Stable | Estimated guest count. A new gig takes it; an existing gig takes it only while its guest count is empty. |
events[].honorees | list of strings | | Stable | People the show honors (the couple, the guest of honor). Each name becomes a guest list entry marked Honoree. Export writes honorees back as guest_list entries with role HONOREE. |
events[].guest_list[].guest_ref | ref → guests[].ref | | Stable | The guest on this gig. |
events[].guest_list[].name | string | | Stable | The name to list when the entry names no guest_ref. It becomes a guest with no contact details. |
events[].guest_list[].plus_count | integer 0–99 | | Stable | Guests beyond the named one. |
events[].guest_list[].pass_type | string | | Stable | One of {options}. COMP when absent. One of COMP, PAID, VIP, ALL_ACCESS, AFTER_SHOW, PHOTO. |
events[].guest_list[].role | string | | Stable | HONOREE marks someone the show honors, as events[].honorees does. |
events[].guest_list[].rsvp_status | string | | Stable | One of ATTENDING | MAYBE | PENDING | INVITED | WAITLIST | DECLINED. ATTENDING when absent. |
events[].guest_list[].meal_choice | string | | Stable | Meal choice. |
events[].guest_list[].notes | string | | Stable | Guest list notes. |
events[].guest_sources[].provider | string | Yes | Stable | Where the gig’s guest list comes from: one of LUMA | PARTIFUL | THE_KNOT | ZOLA | EVENTBRITE | SPREADSHEET | OTHER. Reference only: workspace export lists a gig’s guest sources, and import reads and ignores them, so no source is created and nothing starts syncing. |
events[].guest_sources[].label | string | | Stable | Reference only; import ignores it. |
events[].guest_sources[].external_event_id | string | | Stable | The event’s ID at the provider. Reference only; import ignores it. |
events[].guest_sources[].external_url | string | | Stable | The event’s page at the provider. Reference only; import ignores it. |
events[].guest_sources[].last_synced_at | date-time | | Stable | When Soundcheck last synced this source. Reference only; import ignores it. |
events[].hotel_stays[].hotel_ref | ref → hotels[].ref | Yes | Stable | The hotel the gig stays at. Importing the same stay again (same gig, hotel and check-in date) updates it instead of adding a copy. |
events[].hotel_stays[].check_in_date | YYYY-MM-DD | | Stable | Check-in. |
events[].hotel_stays[].check_out_date | YYYY-MM-DD | | Stable | Check-out. |
events[].hotel_stays[].confirmation_number | string | | Stable | Stay confirmation. |
events[].hotel_stays[].room_count | integer ≥ 1 | | Stable | Rooms. |
events[].hotel_stays[].notes | string | | Stable | Stay notes. |
events[].hotel_stays[].guests[].email | email | Yes | Stable | Email of an active member of the org. An entry naming anyone else is refused and the rest of the gig imports. |
events[].hotel_stays[].guests[].room_number | string | | Stable | Room number. |
events[].hotel_stays[].guests[].confirmation_number | string | | Stable | Guest confirmation. |
events[].hotel_stays[].guests[].notes | string | | Stable | Hotel guest notes. |
events[].hotel_stays[].guests[].check_in_date | YYYY-MM-DD | | Stable | The guest’s own check-in when it differs from the stay’s. Import fills it only on a guest that has none. |
events[].hotel_stays[].guests[].check_out_date | YYYY-MM-DD | | Stable | The guest’s own check-out when it differs from the stay’s. Import fills it only on a guest that has none. |
events[].hotel_stays[].guests[].nights[].night | YYYY-MM-DD | Yes | Stable | A night the guest stays, inside the guest’s check-in and check-out, or the stay’s when the guest has none (checkout exclusive). Import records a guest’s nights only when the guest has none yet; otherwise it keeps the saved nights and says so. Workspace export lists nights only for people with finance access, and import writes them only when the importer may edit finances; otherwise preview and commit warn and leave them out. |
events[].hotel_stays[].guests[].nights[].room_cost | decimal | | Stable | Night room cost. |
events[].hotel_stays[].guests[].nights[].tax_cost | decimal | | Stable | Night tax. |
events[].hotel_stays[].guests[].nights[].currency | string | | Stable | ISO 4217 code. Required when a cost is set. |
events[].hotel_stays[].guests[].nights[].payer | string | | Stable | One of {options}. One of COMPANY, CLIENT, TRAVELLER, OTHER. |
events[].flights[].ref | string | | Stable | A workspace export writes the flight’s ID here, so importing that export back into the same workspace matches each flight to its own record before it compares flight details. |
events[].flights[].airline | string | | Stable | Airline. |
events[].flights[].flight_number | string | | Stable | Importing the same flight again (same gig, flight number and departure) updates nothing and adds no copy. |
events[].flights[].depart_airport | string | | Stable | IATA airport code. |
events[].flights[].arrive_airport | string | | Stable | IATA airport code. |
events[].flights[].depart_at | date-time | | Stable | Departs. |
events[].flights[].depart_timezone | string | | Stable | Departure time zone. |
events[].flights[].arrive_at | date-time | | Stable | Arrives. |
events[].flights[].arrive_timezone | string | | Stable | Arrival time zone. |
events[].flights[].booking_reference | string | | Stable | Booking reference. |
events[].flights[].cost | decimal | | Stable | Workspace export includes it only for people with finance access, and import sets it only when the importer may edit travel costs. |
events[].flights[].cost_currency | string | | Stable | ISO 4217 code. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit travel costs. |
events[].flights[].notes | string | | Stable | Flight notes. |
events[].flights[].status | string | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].estimated_depart_at | date-time | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].estimated_arrive_at | date-time | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].depart_terminal | string | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].depart_gate | string | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].arrive_terminal | string | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].arrive_gate | string | | Stable | Reference only: workspace export lists the live flight status, and import ignores it. |
events[].flights[].passengers[].email | email | Yes | Stable | Email of an active member of the org. An entry naming anyone else is refused and the rest of the gig imports. |
events[].flights[].passengers[].confirmation_code | string | | Stable | Passenger confirmation. |
events[].flights[].passengers[].seat | string | | Stable | Seat. |
events[].flights[].passengers[].ticket_number | string | | Stable | Ticket number. |
events[].flights[].passengers[].baggage_count | integer ≥ 0 | | Stable | Bags. |
events[].flights[].passengers[].notes | string | | Stable | Passenger notes. |
events[].transports[].ref | string | | Stable | A workspace export writes the ride’s ID here, so importing that export back into the same workspace matches each ride to its own record before it compares ride details. |
events[].transports[].kind | string | Yes | Stable | One of {options}. Importing the same ride again (same gig, type, pickup time and place) adds no copy. One of CAR_RENTAL, RIDESHARE, SHUTTLE, VAN, BUS, TRAIN, DRIVER, OTHER. |
events[].transports[].provider | string | | Stable | Ride provider. |
events[].transports[].pickup_location | string | | Stable | Pickup. |
events[].transports[].pickup_at | date-time | | Stable | Pickup time. |
events[].transports[].pickup_timezone | string | | Stable | Pickup time zone. |
events[].transports[].dropoff_location | string | | Stable | Drop-off. |
events[].transports[].dropoff_at | date-time | | Stable | Drop-off time. |
events[].transports[].dropoff_timezone | string | | Stable | Drop-off time zone. |
events[].transports[].vehicle_ref | ref → vehicles[].ref | | Stable | One of the org’s vehicles. |
events[].transports[].vehicle | string | | Stable | Free text when the ride names no vehicle_ref. |
events[].transports[].driver_name | string | | Stable | Driver. |
events[].transports[].driver_phone | phone | | Stable | Driver phone. |
events[].transports[].confirmation_code | string | | Stable | Ride confirmation. |
events[].transports[].cost | decimal | | Stable | Workspace export includes it only for people with finance access, and import sets it only when the importer may edit travel costs. |
events[].transports[].cost_currency | string | | Stable | ISO 4217 code. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit travel costs. |
events[].transports[].payer | string | | Stable | One of {options}. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit travel costs. One of COMPANY, CLIENT, TRAVELLER, OTHER. |
events[].transports[].pickup_instructions | string | | Stable | Pickup instructions. |
events[].transports[].notes | string | | Stable | Ride notes. |
events[].transports[].riders[].email | email | Yes | Stable | Email of an active member of the org. An entry naming anyone else is refused and the rest of the gig imports. |
events[].transports[].riders[].notes | string | | Stable | Rider notes. |
events[].crew_requirements.dress_preset | string | | Stable | The dress code, by the key or label of an org dress preset. Text that names no preset is kept as dress notes. |
events[].crew_requirements.dress_notes | string | | Stable | Extra dress instructions for this gig. |
events[].crew_requirements.reminders | string | | Stable | Reminders for the crew on this gig, one per line. The org standing reminders apply on top. |
events[].assignees[].email | email | Yes | Stable | An active member of the organization, or a person this file adds in members[]. An unknown person is skipped with a warning. |
events[].assignees[].roles | list of strings | | Stable | What the person manages on this gig: {options}. Import adds the roles and never takes one away; it sends no assignment notice. Imported for people who manage gigs; LEAD and FINANCES also need access to gig money. One of LEAD, STAFFING, TASKS, RUN_OF_SHOW, FINANCES. |
events[].contacts[].role | string | | Stable | What the contact does on this show. |
events[].contacts[].name | string | | Stable | The person to reach. A contact needs a name or a company. |
events[].contacts[].company | string | | Stable | The vendor or company, for example the sound vendor. |
events[].contacts[].phone | string | | Stable | Phone number. |
events[].contacts[].email | string | | Stable | Email address. |
events[].contacts[].notes | string | | Stable | Anything else about the contact. |
events[].band_leaders[].name | string | | Stable | A band leader. A crew member on the gig with this name gets the leader role; anyone else becomes a show contact. |
events[].band_leaders[].role | string | | Stable | MD or music director, MC, or leader. |
events[].venue_overrides.parking | string | | Stable | Parking directions for this gig, overriding the venue parking notes. |
events[].venue_overrides.load_in | string | | Stable | Load-in directions or terrain for this gig, overriding the venue load-in notes. |
events[].venue_overrides.green_room | string | | Stable | Where the green room is for this gig, overriding the venue green room instructions. |
events[].venue_overrides.dock | string | | Stable | Loading dock directions for this gig, overriding the venue dock notes. |
events[].venue_overrides.elevator | string | | Stable | Freight elevator details for this gig, overriding the venue elevator notes. |
events[].venue_overrides.load_out | string | | Stable | Load-out directions for this gig, overriding the venue load-out notes. |
events[].venue_overrides.access_code | string | | Stable | A door or gate code for this gig, overriding the venue access code. Workspace export includes it, as it does the venue access code. |
events[].show_notes | list of strings | | Stable | Venue notes for this show, such as shade or weather cover. |
events[].stage_note | string | | Stable | How the stage differs for this gig (size, risers, tech area). It goes on the booked stage, or into a show note when the gig has no single booked stage. Export writes it back as stages[].notes or as that show note. |
events[].stages[].stage_ref | string | Yes | Stable | A stage listed under the gig’s venue: its venues[].stages[].ref, or its name when it has no ref. The gig needs a venue_ref. Importing adds the stage to the gig’s booked stages and leaves stages already booked in place. |
events[].stages[].notes | string | | Stable | How the stage differs for this gig. A gig that already has a note on that stage keeps its own. |
events[].key_times[].kind | string | Yes | Stable | One of {options}. A gig has at most one of each kind per day. One of crew_call, load_in, rehearsal, soundcheck, doors, ceremony, show, set, curfew, load_out. |
events[].key_times[].date | YYYY-MM-DD | Yes | Stable | The gig day the moment falls on, within the gig’s dates. |
events[].key_times[].time | string | Yes | Stable | 24-hour HH:MM on that day. |
events[].key_times[].past_midnight | boolean | | Stable | The time is after midnight but still belongs to that gig day, such as a 01:30 curfew. Only times before 12:00. |
events[].key_times[].note | string | | Stable | Up to 500 characters. Importing never changes a key time someone set on the gig. |
events[].links[].label | string | | Stable | What the link is, for example the stage plot or load-in map. |
events[].links[].url | string | Yes | Stable | An http or https link. |
events[].outside_gear[].name | string | Yes | Stable | Gear someone outside the org brings to the gig. |
events[].outside_gear[].quantity | integer ≥ 1 | | Stable | How many; 1 when omitted. |
events[].outside_gear[].provided_by | string | Yes | Stable | Who brings it: BAND, VENDOR or VENUE. One of BAND, VENDOR, VENUE. |
events[].outside_gear[].provider_name | string | | Stable | The vendor, band or venue by name. |
events[].outside_gear[].notes | string | | Stable | Anything else about the gear. |
events[].ledger_items[].external_id | string | | Stable | The line’s ID in the source system. Without it, a line matches by type, description, amount and date. |
events[].ledger_items[].type | string | Yes | Stable | One of INCOME | EXPENSE | PAYABLE | RECEIVABLE. |
events[].ledger_items[].description | string | Yes | Stable | Ledger line description. |
events[].ledger_items[].amount | decimal | Yes | Stable | A positive amount with at most two decimal places. The type says which way the money moves. |
events[].ledger_items[].currency | string | | Stable | ISO 4217 code. Defaults to the gig’s currency. |
events[].ledger_items[].date | YYYY-MM-DD | | Stable | The business day of the line. Defaults to the gig’s first day. |
events[].ledger_items[].status | string | | Stable | One of UNPAID | PAID. Defaults to PAID for income and expense lines and UNPAID for payables and receivables. |
events[].ledger_items[].recorded_status | string | | Stable | Workspace export writes it when the line’s status in Soundcheck (a paid payable or receivable, or a payment still processing or failed) cannot import as is; status then says UNPAID. On import, PAID on a payable or receivable records the line paid with a manual payment that moves no money, so a restore matches its source. PROCESSING and FAILED import unpaid, with recorded_paid_amount restored as a manual payment when it is set; other values are reference only. |
events[].ledger_items[].recorded_paid_on | YYYY-MM-DD | | Stable | The day of the line’s last payment in Soundcheck, written with recorded_status PAID or recorded_paid_amount. Import dates the restored manual payment on it, or on the line’s date when it is missing. |
events[].ledger_items[].recorded_paid_amount | decimal | | Stable | How much of a payable or receivable that is not fully paid was paid in Soundcheck: its successful payments less reversals and refunds. On import it is restored as one manual payment that moves no money, and the line stays unpaid. It must be more than 0 and less than the line’s amount. |
events[].ledger_items[].counterparty_name | string | | Stable | Who pays or is paid. |
events[].ledger_items[].account_hint | string | | Stable | Name of the organization’s ledger account. Without a match the line goes to the organization’s income or expense account. |
events[].ledger_items[].notes | string | | Stable | Ledger line notes. |
events[].ledger_items[].provenance | object | | Stable | Where this line came from. Kept with the document; not written to the line. |
events[].provenance | object | | Stable | Where this gig came from (source system, source file ids, fetch time). Kept with the document; not written to the gig, except catalog_key on a TEMPLATE gig: a Soundcheck starter gig key matches the org’s gig template with the same key before anything else (a matched template is left unchanged), and a new gig template stores it. |
events[].template_timing.start_clock | string | Yes | Stable | The gig start as an HH:mm wall clock in the org’s timezone. Used only for a TEMPLATE gig with no event_date: the gig is then written on the org’s current day, since a template’s date is only an anchor that a copy moves, and its sections become that day’s run of show. Otherwise template_timing is ignored. |
events[].template_timing.duration_minutes | integer 0–10080 | Yes | Stable | Minutes from the template start to the gig end. |
events[].template_timing.sections[].title | string | Yes | Stable | Template rundown block. |
events[].template_timing.sections[].notes | string | | Stable | Template rundown block notes. |
events[].template_timing.sections[].start_offset_minutes | integer -10080–10080 | | Stable | Start as minutes after the template start; negative is before it. |
events[].template_timing.sections[].duration_minutes | integer 0–10080 | | Stable | Template rundown block length. |
events[].template_timing.sections[].item_type | string | | Stable | general or break. Defaults to general. |
events[].days[].run_of_show[].provenance | object | | Stable | Where this cue came from. Kept with the document; not written to the cue. |
events[].shifts[].crew[].provenance | object | | Stable | Where this person came from. Kept with the document; not written to the invitation. |
events[].labels | list of refs → labels[].ref | | Stable | Labels on the gig, by labels[].ref. Import adds them and never takes a label off. |
events[].checklist[].title | string | Yes | Stable | Checklist phase. |
events[].checklist[].kind | string | | Stable | One of {options}. A gig has at most one UNCATEGORIZED phase. A phase matches the gig’s phase with the same title, ignoring case. One of STANDARD, UNCATEGORIZED. |
events[].checklist[].tasks[].ref | string | | Stable | A workspace export writes the task’s ID here, so importing it back finds the task before it compares titles. A matched task is not changed, and import never removes a task. |
events[].checklist[].tasks[].title | string | Yes | Stable | Checklist task. |
events[].checklist[].tasks[].status | string | | Stable | One of {options}. Defaults to NOT_STARTED. One of NOT_STARTED, IN_PROGRESS, COMPLETE. |
events[].checklist[].tasks[].notes | string | | Stable | Checklist task notes. |
events[].checklist[].tasks[].due_date | YYYY-MM-DD | | Stable | Checklist task due. |
events[].checklist[].tasks[].assignee_email | email | | Stable | Email of an active member of the org. Anyone else is left off the task, with a note. |
events[].checklist[].tasks[].labels | list of refs → labels[].ref | | Stable | Labels on the task, by labels[].ref. |
events[].sponsor_commitments[].ref | string | | Stable | A workspace export writes the deal’s ID here, so importing it back finds the deal before it compares sponsor, title and due date. A matched deal is not changed. |
events[].sponsor_commitments[].sponsor_ref | ref → sponsors[].ref | Yes | Stable | Gig sponsor. |
events[].sponsor_commitments[].title | string | Yes | Stable | Gig sponsor deal. |
events[].sponsor_commitments[].amount | decimal | | Stable | A new deal needs it and posts it to the ledger as a receivable on the gig. Workspace export includes it only for people with finance access, and import sets it only when the importer may edit finances. |
events[].sponsor_commitments[].currency | string | | Stable | ISO 4217 code. Defaults to USD. |
events[].sponsor_commitments[].status | string | | Stable | Gig sponsor deal status. |
events[].sponsor_commitments[].due_date | YYYY-MM-DD | | Stable | Gig sponsor deal due. |
events[].sponsor_commitments[].paid_at | date-time | | Stable | Gig sponsor deal paid. |
events[].sponsor_commitments[].notes | string | | Stable | Gig sponsor deal notes. |
events[].labor_call.union_local | string | | Stable | Import fills the labor call details a gig does not have yet and never changes ones it has. |
events[].labor_call.steward | string | | Stable | Union steward. |
events[].labor_call.steward_call | string | | Stable | 24-hour HH:MM in the gig timezone. |
events[].labor_call.head_electrician | string | | Stable | Head electrician. |
events[].labor_call.head_electrician_call | string | | Stable | 24-hour HH:MM in the gig timezone. |
events[].labor_call.notes | string | | Stable | Labor call notes. |
events[].labor_call.departments[].department | string | Yes | Stable | Import adds a department the gig does not have, matched by name ignoring case, and never changes or removes one it has. |
events[].labor_call.departments[].load_in_call | string | | Stable | 24-hour HH:MM in the gig timezone. |
events[].labor_call.departments[].load_in_hands | number | | Stable | A headcount of local hands. Defaults to 0. |
events[].labor_call.departments[].show_call | string | | Stable | 24-hour HH:MM in the gig timezone. |
events[].labor_call.departments[].show_hands | number | | Stable | Defaults to 0. |
events[].labor_call.departments[].load_out_call | string | | Stable | 24-hour HH:MM in the gig timezone. A call earlier than the show call falls on the next morning. |
events[].labor_call.departments[].load_out_hands | number | | Stable | Defaults to 0. |
events[].labor_call.departments[].notes | string | | Stable | Labor call notes. |
events[].holds[].kind | string | Yes | Stable | Reference only: workspace export lists the space and person holds on a gig, and import reads and ignores them, so no hold is created. One of space, person. |
events[].holds[].day | YYYY-MM-DD | Yes | Stable | Reference only; import ignores it. |
events[].holds[].space | string | | Stable | Reference only; import ignores it. |
events[].holds[].venue | string | | Stable | Reference only; import ignores it. |
events[].holds[].status | string | | Stable | Reference only; import ignores it. |
events[].holds[].rank | number | | Stable | Reference only; import ignores it. |
events[].holds[].holder_name | string | | Stable | Reference only; import ignores it. |
events[].holds[].email | string | | Stable | Reference only; import ignores it. |
events[].holds[].type | string | | Stable | HOLD or PAID_HOLD. Reference only; import ignores it. |
events[].deal.deal_type | string | | Stable | FLAT_GUARANTEE | VERSUS | DOOR_SPLIT | GUARANTEE_PLUS_BONUS. Import sets a gig’s deal only when the gig has no deal of its own (none yet, or only terms copied from its project), the importer may edit finances, and deals are on for the organization. A gig that already has its own deal, a signed one, an invoice or a show settlement is left unchanged, with a note. Workspace export includes the deal only for people with finance access. |
events[].deal.org_side | string | | Stable | SELLER | BUYER. SELLER is paid; BUYER pays the act. |
events[].deal.counterparty_name | string | | Stable | Deal counterparty. |
events[].deal.guarantee | decimal | | Stable | Guarantee. |
events[].deal.currency | string | | Stable | ISO 4217 code. Defaults to the gig’s currency. |
events[].deal.split_percent | decimal | | Stable | The share of the box office for a versus or door split deal, 0 to 100. |
events[].deal.split_basis | string | | Stable | GROSS | NET. |
events[].deal.installments[].label | string | Yes | Stable | Deal deposit. |
events[].deal.installments[].amount | decimal | | Stable | Give the amount or percent_of_guarantee, not both. |
events[].deal.installments[].percent_of_guarantee | decimal | | Stable | Percent of the guarantee, 0 to 100. Give the amount or percent_of_guarantee, not both. |
events[].deal.installments[].due_rule | string | Yes | Stable | ON_DATE | DAYS_AFTER_SIGNING | DAYS_BEFORE_EVENT. ON_DATE takes due_on; the other two take due_days. |
events[].deal.installments[].due_on | YYYY-MM-DD | | Stable | Deal deposit due date. |
events[].deal.installments[].due_days | number | | Stable | Deal deposit due days. |
events[].deal.bonus_tiers[].tickets_sold | number | Yes | Stable | Bonus tier tickets. |
events[].deal.bonus_tiers[].amount | decimal | Yes | Stable | Bonus tier amount. |
events[].settlement.revision | number | | Stable | The locked show settlement of the gig. Reference only: workspace export lists it for people with finance access, and import reads and ignores it. A locked settlement has posted ledger items, so it never imports. |
events[].settlement.org_side | string | | Stable | Reference only; import ignores it. |
events[].settlement.currency | string | | Stable | Reference only; import ignores it. |
events[].settlement.balance | decimal | | Stable | Reference only; import ignores it. |
events[].settlement.adjustment | decimal | | Stable | Reference only; import ignores it. |
events[].settlement.locked_at | date-time | | Stable | Reference only; import ignores it. |
events[].settlement.org_approved_name | string | | Stable | Reference only; import ignores it. |
events[].settlement.org_approved_at | date-time | | Stable | Reference only; import ignores it. |
events[].settlement.counterparty_approved_name | string | | Stable | Reference only; import ignores it. |
events[].settlement.counterparty_approved_at | date-time | | Stable | Reference only; import ignores it. |
events[].invoices[].number | string | | Stable | Reference only: workspace export lists it for people with finance access, and import reads and ignores it. No payment provider ids and no PDFs; invoices never import. |
events[].invoices[].status | string | | Stable | Reference only; import ignores it. |
events[].invoices[].issue_date | YYYY-MM-DD | | Stable | Reference only; import ignores it. |
events[].invoices[].due_date | YYYY-MM-DD | | Stable | Reference only; import ignores it. |
events[].invoices[].currency | string | | Stable | Reference only; import ignores it. |
events[].invoices[].subtotal | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].discount | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].tax_total | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].total | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].paid | decimal | | Stable | What has been paid, including tax. Reference only; import ignores it. |
events[].invoices[].balance | decimal | | Stable | What is still owed. Reference only; import ignores it. |
events[].invoices[].lines[].description | string | | Stable | Reference only; import ignores it. |
events[].invoices[].lines[].quantity | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].lines[].unit_amount | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].lines[].tax_rate | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].lines[].tax | decimal | | Stable | Reference only; import ignores it. |
events[].invoices[].lines[].amount | decimal | | Stable | Reference only; import ignores it. |
events[].quotes[].status | string | | Stable | Reference only: workspace export lists a gig’s quotes for people who manage gigs, and import reads and ignores them. Costs, margins, the client’s intake answers and Flex quotes stay out; quotes never import. |
events[].quotes[].source | string | | Stable | Reference only; import ignores it. |
events[].quotes[].created_at | date-time | | Stable | Reference only; import ignores it. |
events[].quotes[].currency | string | | Stable | Reference only; import ignores it. |
events[].quotes[].subtotal | decimal | | Stable | Reference only; import ignores it. |
events[].quotes[].estimate_low | decimal | | Stable | Reference only; import ignores it. |
events[].quotes[].estimate_high | decimal | | Stable | Reference only; import ignores it. |
events[].quotes[].lines[].name | string | | Stable | Reference only; import ignores it. |
events[].quotes[].lines[].unit | string | | Stable | Reference only; import ignores it. |
events[].quotes[].lines[].quantity | decimal | | Stable | Reference only; import ignores it. |
events[].quotes[].lines[].unit_rate | decimal | | Stable | Reference only; import ignores it. |
events[].quotes[].lines[].line_total | decimal | | Stable | Reference only; import ignores it. |
events[].review.rating | number | | Stable | The post-gig rating of the gig. Reference only: workspace export lists gig and venue ratings, and import reads and ignores them. Ratings of crew members never export. |
events[].review.notes | string | | Stable | Reference only; import ignores it. |
events[].review.venues[].name | string | | Stable | The venue as used on this gig. Reference only; import ignores it. |
events[].review.venues[].rating | number | | Stable | Reference only; import ignores it. |
events[].review.venues[].notes | string | | Stable | Reference only; import ignores it. |
events[].live_page.published | boolean | | Stable | Reference only: workspace export lists a gig’s live page settings for people who manage gigs, and import reads and ignores them. The page’s code and collaborator shares never export; a live page is published from the gig page. |
events[].live_page.delay_minutes | number | | Stable | Minutes the show is running late. Reference only; import ignores it. |
events[].live_page.announcement | string | | Stable | Reference only; import ignores it. |
events[].live_page.hidden_section_ids | list of strings | | Stable | Run of show sections hidden from the page, by Soundcheck id. Reference only; import ignores it. |
events[].live_page.shown_section_ids | list of strings | | Stable | Run of show sections shown on the page, by Soundcheck id. Reference only; import ignores it. |