> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soundchecklive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gigs, projects and leads import fields

> Import file fields (version 2.0) for projects, gigs with their shifts and schedules, and leads, with an example for each.

These are the fields for projects, gigs with their shifts and schedules, and leads. How to read a row, the fields at the top of the file and the other records are in [Import file fields](https://docs.soundchecklive.io/features/imports/import-format-reference.md). Every field here is Stable for version 2.x.

***

## Projects (`projects[]`)

Tours, festivals, residencies and other bodies of work that own gigs. A gig without a project gets its own one-gig project. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it, and an `external_id` (its ID in your other system) so importing the file again updates that record instead of adding a copy.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `projects[].ref` | string | | Stable | Name for this project inside the document, used by project\_ref and affiliated\_project\_refs. |
| `projects[].external_id` | string | | Stable | The project's ID in the source system. A re-import with the same ID updates the same project. |
| `projects[].name` | string | Yes | Stable | Project name. |
| `projects[].description` | string | | Stable | Project description. |
| `projects[].status` | string | | Stable | One of PLANNING \| CONFIRMED \| COMPLETED \| CANCELLED \| ARCHIVED. Defaults to PLANNING. |
| `projects[].client_ref` | ref → `clients[].ref` | | Stable | Project client. |
| `projects[].start_date` | `YYYY-MM-DD` | | Stable | Project start date. |
| `projects[].end_date` | `YYYY-MM-DD` | | Stable | Project end date. |
| `projects[].hide_from_crew` | boolean | | Stable | Hide the project's name and details from crew. |
| `projects[].deal_defaults.org_side` | string | | Stable | SELLER \| BUYER. Project defaults hold a flat guarantee. Import sets defaults only on a project that has none, only when the importer may edit finances, and only when deals are on for the organization; gigs in the project with no deal of their own copy them. BUYER needs the same. |
| `projects[].deal_defaults.guarantee` | decimal | | Stable | Default guarantee. |
| `projects[].deal_defaults.currency` | string | | Stable | ISO 4217 code. Defaults to USD. |
| `projects[].deal_defaults.installments[].label` | string | Yes | Stable | Default deposit. |
| `projects[].deal_defaults.installments[].amount` | decimal | | Stable | Give the amount or percent\_of\_guarantee, not both. |
| `projects[].deal_defaults.installments[].percent_of_guarantee` | decimal | | Stable | Percent of the guarantee, 0 to 100. Give the amount or percent\_of\_guarantee, not both. |
| `projects[].deal_defaults.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. |
| `projects[].deal_defaults.installments[].due_on` | `YYYY-MM-DD` | | Stable | Default deposit due date. |
| `projects[].deal_defaults.installments[].due_days` | number | | Stable | Default deposit due days. |
| `projects[].trips[].name` | string | Yes | Stable | Import creates the trip in its project, with the gigs it lists that this import wrote. A trip already in the project by that name is left as it is, so a re-import adds none. The trip's flights, stays and rides are not attached, and Brex mappings never export. |
| `projects[].trips[].primary_event_ref` | ref → `events[].ref` | | Stable | The gig the trip bills through, by events\[].ref. Defaults to the first gig the trip lists. |
| `projects[].trips[].event_refs` | list of refs → `events[].ref` | | Stable | The gigs the trip covers, by events\[].ref. Each must belong to the same project. |
| `projects[].trips[].buyouts[].category` | string | | Stable | One of \{options}, each at most once per trip. Workspace export lists buyouts 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. One of `FLIGHTS`, `LODGING`, `GROUND`. |
| `projects[].trips[].buyouts[].amount` | decimal | | Stable | Non-negative, at most 2 decimals. |
| `projects[].trips[].buyouts[].currency` | string | | Stable | ISO 4217 code. Every buyout on a trip uses the same currency. |
| `projects[].trips[].buyouts[].notes` | string | | Stable | Trip buyout notes. |

### Example: projects

A tour that owns gigs, linked to its client by ref.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PARTNER",
    "name": "acme-booking-feed"
  },
  "clients": [
    {
      "ref": "riverside",
      "name": "Riverside Events Collective"
    }
  ],
  "projects": [
    {
      "ref": "summer",
      "external_id": "PRJ-2026-SUMMER",
      "name": "Riverside Summer Series 2026",
      "status": "CONFIRMED",
      "client_ref": "riverside",
      "start_date": "2026-06-01",
      "end_date": "2026-08-31"
    }
  ]
}
```

***

## Gigs (`events[]`)

Gigs, each with its days, run of show, shifts and crew. Give a record a `ref` (any short name, such as `main-stage`) so other records in the same file can point at it, and an `external_id` (its ID in your other system) so importing the file again updates that record instead of adding a copy.

Each `events[].pack_items[]` needs at least one of `name` or `external_id`.

Each `events[].guest_list[]` needs at least one of `guest_ref` or `name`.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `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. |

### Example: gigs

A one-day gig with an inline venue, a run of show, a staffed shift, a gear line and a deposit.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PARTNER",
    "name": "acme-booking-feed"
  },
  "events": [
    {
      "ref": "gala",
      "external_id": "BK-5531",
      "title": "Hillcrest Foundation Gala",
      "event_date": "2026-09-12",
      "event_type": "Corporate",
      "timezone": "America/Chicago",
      "status": "DRAFT",
      "currency": "USD",
      "key_times": [
        {
          "kind": "load_in",
          "date": "2026-09-12",
          "time": "14:00"
        },
        {
          "kind": "doors",
          "date": "2026-09-12",
          "time": "18:00"
        },
        {
          "kind": "curfew",
          "date": "2026-09-12",
          "time": "00:30",
          "past_midnight": true
        }
      ],
      "venue": {
        "name": "Hillcrest Ballroom",
        "city": "Dallas",
        "state": "TX"
      },
      "days": [
        {
          "date": "2026-09-12",
          "phases": [
            "LOAD_IN",
            "SHOW",
            "LOAD_OUT"
          ],
          "run_of_show": [
            {
              "name": "Load in",
              "start": "14:00"
            },
            {
              "name": "Doors",
              "start": "18:00"
            },
            {
              "name": "Band set",
              "start": "21:00",
              "end": "23:30"
            },
            {
              "name": "Strike",
              "start": "00:00",
              "days_later": 1
            }
          ]
        }
      ],
      "shifts": [
        {
          "title": "A1",
          "position": "FOH Engineer",
          "seats": 2,
          "fee": 400,
          "fee_type": "FIXED",
          "crew": [
            {
              "first_name": "Dana",
              "last_name": "Reyes",
              "email": "dana@example.com"
            }
          ]
        }
      ],
      "pack_items": [
        {
          "name": "Shure SM58",
          "quantity": 6
        }
      ],
      "ledger_items": [
        {
          "type": "RECEIVABLE",
          "description": "Deposit",
          "amount": 2500,
          "date": "2026-07-01",
          "counterparty_name": "Hillcrest Foundation"
        }
      ]
    }
  ]
}
```

***

## Leads (`leads[]`)

Booking inquiries.

| Field | Type | Required | Status | Notes |
| - | - | - | - | - |
| `leads[].provenance` | object | | Stable | Where this lead came from. Kept with the document; not written to the lead. |
| `leads[].event_ref` | ref → `events[].ref` | | Stable | The gig this inquiry is about, by its ref in this document. |
| `leads[].name` | string | Yes | Stable | Full name of the prospective client / deal contact. |
| `leads[].email` | email | Yes | Stable | Client email — also the dedup key for the lead. |
| `leads[].phone` | phone | | Stable | Client phone. |
| `leads[].event_date` | `YYYY-MM-DD` | Yes | Stable | The requested event date. |
| `leads[].event_type` | string | | Stable | Category of event — Wedding, Corporate, etc. |
| `leads[].location` | string | | Stable | Event location / venue text. |
| `leads[].latitude` | decimal | | Stable | Latitude. |
| `leads[].longitude` | decimal | | Stable | Longitude. |
| `leads[].deal_stage` | string | | Stable | HubSpot pipeline stage. Leads in/past the operator-selected 'Quote Requested' stage also become events. |
| `leads[].budget` | string | | Stable | Budget range or amount — stored as free text. |
| `leads[].message` | string | | Stable | Additional details about the request. |
| `leads[].status` | string | | Stable | PENDING \| COMPLETED. Defaults to PENDING. |
| `leads[].external_id` | string | | Stable | Source deal identifier. Recommended — links the lead to its derived event. |

### Example: leads

A booking inquiry.

```json theme={null}
{
  "schema_version": "2.0",
  "source": {
    "type": "PARTNER",
    "name": "website-inquiries"
  },
  "leads": [
    {
      "external_id": "WEB-881",
      "name": "Priya Shah",
      "email": "priya@example.com",
      "event_date": "2027-05-22",
      "event_type": "Wedding",
      "location": "Austin, TX",
      "message": "Looking for a band and sound for 150 guests."
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.