Documentation menu

Help Scout#

Connect Help Scout with OAuth using your Help Scout app credentials. The source writes 6 fixed tables under titan.helpscout.

sql
select
  id,
  first_name,
  last_name
from titan.helpscout.customers
limit 10

Connect Help Scout#

  1. Open Apps, choose Connect app, and select Help Scout.

  2. Enter OAuth using your Help Scout app credentials.

  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#

Customers, conversations, mailboxes, users, tags, and workflows share one source schedule.

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#

customers#

titan.helpscout.customers has 7 source columns.

helpscout.customers7 columns
idintegerpk

Source field id.

first_namestring

Source field firstName.

last_namestring

Source field lastName.

emailstring

Source field email.

companystring

Source field company.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

conversations#

titan.helpscout.conversations has 10 source columns.

helpscout.conversations10 columns
idintegerpk

Source field id.

numberinteger

Source field number.

subjectstring

Source field subject.

statusstring

Source field status.

typestring

Source field type.

mailbox_idinteger

Source field mailboxId.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

closed_atdatetime

Source field closedAt.

assigneejson

Source field assignee.

mailboxes#

titan.helpscout.mailboxes has 5 source columns.

helpscout.mailboxes5 columns
idintegerpk

Source field id.

namestring

Source field name.

emailstring

Source field email.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

users#

titan.helpscout.users has 7 source columns.

helpscout.users7 columns
idintegerpk

Source field id.

first_namestring

Source field firstName.

last_namestring

Source field lastName.

emailstring

Source field email.

rolestring

Source field role.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

tags#

titan.helpscout.tags has 3 source columns.

helpscout.tags3 columns
idintegerpk

Source field id.

namestring

Source field name.

colorstring

Source field color.

workflows#

titan.helpscout.workflows has 6 source columns.

helpscout.workflows6 columns
idintegerpk

Source field id.

namestring

Source field name.

typestring

Source field type.

statusstring

Source field status.

created_atdatetime

Source field createdAt.

modified_atdatetime

Source field modifiedAt.

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.