Home Schema Example JSON Schema

Provider Settings


ProviderApplication.provider_settings are used to store provider-specific settings such as API keys.

No Additional Properties

Type: object

The following properties are required:

  • acuity
Type: object

The following properties are required:

  • calendly
Type: object

The following properties are required:

  • google_calendar
Type: object

The following properties are required:

  • hummingbird
Type: object

The following properties are required:

  • icalendar
Type: object

The following properties are required:

  • mandaya
Type: object

The following properties are required:

  • cleo
Type: object

The following properties are required:

  • noop

Acuity

Type: object

Settings for AcuityProvider.

No Additional Properties

User ID

Type: string

User ID generated by actuity. Obtain this information in Acuity Dashboard -> Integrations -> API -> Credentials.

Must be at least 1 characters long

API Key

Type: string

API Key generated by actuity. Obtain this information in Acuity Dashboard -> Integrations -> API -> Credentials.

Must be at least 1 characters long

Calendly

Type: object

Settings for CalendlyProvider.

No Additional Properties

Personal Access Token

Type: string

Personal access token for accessing the Calendly API obtained from API Integrations. We currently do not handle the OAuth 2.0 flow and will use the generated token in the Authorization: Bearer header

Must be at least 1 characters long

Signing key

Type: string

Signing key used to validate incoming webhook payload. This is a randomly generated string by the user.

Must be at least 16 characters long

Organization URI

Type: stringFormat: uri

The unique reference to the organization. Get it via the API from here.

User URI

Type: stringFormat: uri

The unique reference to the user. Get it via the API from here.

Scope

Type: enum (of string)

Whether to use the Calendly API as a user or organization. Defaults to user.

Must be one of:

  • "user"
  • "organization"

Cleo

Type: object

Settings for CleoProvider.

No Additional Properties

API Key

Type: string

API Key generated for cleo provider to decrypt webhook payload.

Must be at least 1 characters long

Google Calendar

Type: object

Settings for GoogleCalendarProvider.

No Additional Properties

Calendar ID

Type: string

Calendar identifier. You can get this via API (or the API explorer).

Must be at least 1 characters long

Token

Type: string

An arbitrary string delivered to the target address with each notification.

Must be at least 1 characters long

All Day Event

Type: object

Specifies default start/end time for all day events.

No Additional Properties

Timezone

Type: string

Timezone for the all day event. Defaults to UTC.

Must be at least 1 characters long

Start Time

Type: stringFormat: time

Start time in the calendar timezone. Defaults to 00:00.

End Time

Type: stringFormat: time

End time in the calendar timezone. Defaults to 00:00.

Google Cloud Credentials

Type: object

The service account credentials.

Type

Type: const

Credential type. Must be service_account.

Specific value: "service_account"

Private Key

Type: string

Private key associated with the credential.

Must be at least 1 characters long

Additional Properties of any type are allowed.

Type: object

Resource ID

Type: string

Resource ID returned by calendar events watch API. This can be found in the X-Goog-Resource-Id header of watch incoming webhooks and is also populated during the upsert_webhook call. This value is required during webhook deletion.

Must be at least 1 characters long

Sync Window

Type: object

Events within this window will be synced.

No Additional Properties

Before

Type: integer

Number of seconds before now to sync events. Defaults to 604800 (i.e., 7 days).

Value must be greater or equal to 1

Before

Type: integer

Number of seconds after now to sync events. Defaults to 2592000 (i.e., 30 days).

Value must be greater or equal to 1

Sync Token (Unused)

Type: string

Sync token stored during the initial sync according to Synchronize Resources Efficiently guide. This is currently not used.

Must be at least 1 characters long

Sync Token Updated On (Unused)

Type: stringFormat: date-time

Date/time the sync token was updated. This is currently not used.

HummingBird

Type: object

Settings for HummingBirdProvider.

No Additional Properties

API Key

Type: string

API Key generated by HummingBird.

Must be at least 1 characters long

API URL

Type: stringFormat: uri

URL of HummingBird API server.

Must be at least 1 characters long

Token URL

Type: stringFormat: uri

URL to get verification token from HummingBird server.

Must be at least 1 characters long

iCalendar

Type: object

Settings for ICalendarProvider.

No Additional Properties

URL

Type: string

URL to download the calendar file from.

Must be at least 1 characters long

Token

Type: string

Token for triggering a sync via webhook.

Must be at least 16 characters long

All Day Event

Type: object

Specifies default start/end time for all day events.

Same definition as all_day_event

Sync Window

Type: object

Events within this window will be synced.

Same definition as sync_window

Mandaya

Type: object

Settings for MandayaProvider.

No Additional Properties

API Key

Type: string

API Key generated by mandaya. This key will be used to decrypt webhook payload.

Must be at least 1 characters long

Noop

Type: object

Settings for NoopProvider.

Question-Answer (QA) Parser Settings

Type: object

QAParser.settings describes how fields can be parsed and extracted out of QAPairs. The basis of QAParser is QAField which describe individual normalized values that are extracted.
During extraction, QAFields are iterated in a sequence for each QAPair to attempt extraction. As such, the order of precedence for non-array fields (i.e., is_array = false) are such that values extracted from later QAFields override earlier ones.
For array QAFields (i.e., is_array = true), the extracted values are concatenated together.

No Additional Properties

Fields

Type: array

An array of Field describing the how and what to extract from a QAPair.

All items must be unique

No Additional Items

Each item of this array must be:

Field

Type: object

A field describes how to identify and extract the value from a Question-Answer pair.

No Additional Properties

Key

Type: string

The extracted value will be associated with this key.

Must be at least 1 characters long

Regex Matches

Type: string

Regular expression pattern that will be used to search the question text. We use Python regular expressions and re.search for matching.

Must be at least 1 characters long

Type

Type: enum (of string)

Type of the extracted value. Defaults to string.
- For number, we will convert the value to float. - For boolean, we support handling of non-zero numbers, yes, and true. All other values are deemed as false.

Must be one of:

  • "string"
  • "number"
  • "boolean"
  • "datetime"
  • "time"
  • "file"

Is Array

Type: boolean

If is_array and there are multiple question-field matches, the entries will be grouped together into a list.
If not is_array and the answer value is already a list, only the first element will be used.
Defaults to false.

Case Sensitive

Type: boolean

Set this to true to use case-sensitive regex search. Defaults to false.

Parser Error

Type: enum (of string)

Action to take during parser error. Defaults to raise.

Must be one of:

  • "ignore"
  • "raise"

Default


Default value to use when this field is not set.

String

Type: string

Number

Type: number

Boolean

Type: boolean

Array of Strings

Type: array of string
No Additional Items

Each item of this array must be:

Null

Type: const
Specific value: null

Normalize (For `string` only)

Type: array of object

Normalize value to a specific set of choices using Regex. The first matching regex in this array will be used as the normalized choice. If no matches are found, the original string value is used. Only applies to string type.

Must contain a minimum of 0 items

No Additional Items

Each item of this array must be:

Type: object
No Additional Properties

Regex

Type: string

Regular expression to match for normalization.

Must be at least 1 characters long

Cjoice

Type: string

Choice to be returned by the parser.

Datetime Format

Type: string

Use the given format string for parsing date/datetime. Defaults to dateutil.parser.parse(value, dayfirst=True, default=today_midnight).

Must be at least 1 characters long

Time Format

Type: string

Use the given format string for parsing time. Defaults to dateutil.parser.parse(value, dayfirst=True, default=today_midnight).

Must be at least 1 characters long

Default Time

Type: stringFormat: time

For date-time fields that are date only, this will be the default time added to it. Defaults to 08:00.

Timezone

Type: string

Ensures that the timezone of any parsed DATETIME or TIME field is localized to this timezone. Defaults to UTC.

Must be at least 1 characters long