Documentation menu

Zendesk#

Connect Zendesk with a subdomain, email address, and API token. The source writes 43 core and child tables plus discovered custom fields under titan.zendesk.

Connect Zendesk#

  1. Open Apps, choose Connect app, and select Zendesk.

  2. Enter a subdomain, email address, and API token.

  3. Review the tables, then save the source.

  4. Watch Sync history until the first run completes.

Credentials are stored as secrets. They never become lake columns or appear in query results.

Sync behavior#

Ticket, user, and organization custom fields become columns. Tags, comments, attachments, identities, and domains remain queryable child tables.

A new source syncs when you connect it and then follows its schedule. The default recurring interval is 4 hours. An interrupted run keeps its completed progress and retries safely.

Every lake table also has the system columns _synced_at and _deleted; the column reference below lists source columns only.

Table reference#

Supernova discovers this reference from the connected account. Zendesk field APIs supply tenant-specific custom columns. The Tables tab shows the resulting core, child, and custom-field reference.

Open Apps → Zendesk → Tables after the first discovery run to see every exact table name, column name, type, and sync selection. Dynamic fields cannot be listed truthfully before an account is connected.

Deletes and history#

Rows are merged by their source key. When the source can prove that a row was deleted, Supernova keeps the row and sets _deleted so queries can choose whether to include history. Filter current-state queries with where not _deleted.