Skip to main content

Goldcast

This page contains the setup guide and reference information for the Goldcast source connector.

Prerequisites

  • A Goldcast Pro plan or higher. The Starter plan does not allow API access.
  • API tokens enabled for your Goldcast organization. Goldcast disables tokens by default, so if your plan includes API access, contact Goldcast support to turn them on.
  • A Goldcast API token. Follow Goldcast's guide to create one in Goldcast Studio under Settings > Tokens. If your organization uses Goldcast Teams, only organization admins can create tokens. Goldcast shows the token value only once, so copy it when you create it. The token is case-sensitive.

Setup guide

For Airbyte Cloud

To set up Goldcast as a source in Airbyte Cloud:

  1. Log in to your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click + New source.
  3. Find and select Goldcast from the list of available sources.
  4. Enter a Source name of your choosing.
  5. Enter the Access Key (the API token you created in Goldcast).
  6. Click Set up source and wait for the tests to complete.

For Airbyte Open Source

To set up Goldcast as a source in Airbyte Open Source:

  1. Log in to your Airbyte Open Source account.
  2. In the left navigation bar, click Sources. In the top-right corner, click + New source.
  3. Find and select Goldcast from the list of available sources.
  4. Enter a Source name of your choosing.
  5. Enter the Access Key (the API token you created in Goldcast).
  6. Click Set up source and wait for the tests to complete.

Supported Sync Modes

The Goldcast source connector supports the following sync modes:

Incremental modes are not supported because the Goldcast API does not expose a cursor field, such as a modified-at timestamp, that the connector can filter on.

Supported Streams

The Goldcast source connector can sync the following streams. See the Goldcast API documentation for details on each endpoint.

StreamDescription
organizationsYour Goldcast organization and its workspace settings.
eventsAll events of every type (webinars, conferences, and so on).
event_membersRegistrants and attendees of each event. Child of events. See The props field.
webinarsWebinar settings for each event. Child of events, limited to events whose type is Webinar.
tracksTracks associated with your events.
agenda_itemsAgenda items associated with your events.
discussion_groupsDiscussion groups associated with your events.

The connector requests list endpoints with limit/offset pagination, 100 records per page. The webinars stream is scoped to webinar-type events because the Goldcast webinars endpoint returns an error for other event types.

The props field in event_members

Each event_members record has a props object that holds the registration form fields for that registrant, such as UTM parameters or job title. Goldcast lets every workspace define its own registration fields, so the connector doesn't declare a fixed set of properties inside props. It syncs props as a schemaless object that contains whatever fields your workspace collects.

How props lands in your destination depends on the destination:

  • Database and data lake destinations store props as a single JSON value with every field intact.
  • S3 and GCS destinations writing Avro or Parquet files store props as a JSON string. To read individual fields, parse that string in your query engine instead of addressing props.<field> as a nested column.

Before version 1.0.0, the connector declared eleven fixed fields inside props, and Avro and Parquet files silently dropped any other registration field. If you're upgrading from an earlier version, see the migration guide.

IP allow list

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference

Config fields reference

Field
Type
Property name
string
access_key

Changelog

Expand to review
VersionDatePull RequestSubject
1.0.02026-09-1582770Make event_members props schemaless so every workspace-defined registration field is preserved on S3/GCS Avro and Parquet destinations; see the migration guide
0.2.262026-08-2083237Fix connector broken by Goldcast's API changes: list streams now request limit/offset pagination and extract records from the results envelope, and the webinars stream is scoped to webinar-type events only to avoid errors on other event types
0.2.252026-06-0278729Update dependencies
0.2.242025-05-1059909Update dependencies
0.2.232025-05-0359258Update dependencies
0.2.222025-04-2658791Update dependencies
0.2.212025-04-1958182Update dependencies
0.2.202025-04-1257670Update dependencies
0.2.192025-04-0557206Update dependencies
0.2.182025-03-2956472Update dependencies
0.2.172025-03-2255958Update dependencies
0.2.162025-03-0855274Update dependencies
0.2.152025-03-0154953Update dependencies
0.2.142025-02-2254439Update dependencies
0.2.132025-02-1553762Update dependencies
0.2.122025-02-0853338Update dependencies
0.2.112025-02-0152838Update dependencies
0.2.102025-01-2552325Update dependencies
0.2.92025-01-1851636Update dependencies
0.2.82025-01-1151103Update dependencies
0.2.72024-12-2850571Update dependencies
0.2.62024-12-2149998Update dependencies
0.2.52024-12-1449480Update dependencies
0.2.42024-12-1249158Update dependencies
0.2.32024-11-0448148Update dependencies
0.2.22024-10-2947875Update dependencies
0.2.12024-10-2847533Update dependencies
0.2.02024-08-2244568Refactor connector to manifest-only format
0.1.82024-08-1243804Update dependencies
0.1.72024-08-1043522Update dependencies
0.1.62024-08-0343284Update dependencies
0.1.52024-07-2742616Update dependencies
0.1.42024-07-2042237Update dependencies
0.1.32024-07-1341806Update dependencies
0.1.22024-07-1041406Update dependencies
0.1.12024-07-0941263Update dependencies
0.1.02024-06-2638786New Source: Goldcast