Introduction
The Stitch Connect API enables users to programmatically access and manage their Stitch accounts, or Stitch partners to seamlessly integrate Stitch’s data pipleine functionality into their own platforms.
This API is a RESTful, resource-oriented API that allows you to programmatically provision Stitch accounts, create and modify data sources, and configure destination connections.
Each endpoint uses standard HTTP verbs like GET and POST, and will return standard HTTP response codes to indicate request status or errors.
We built the API to accept and return JSON in all responses, including errors.
API functionality
Using the API, you can:
-
Create Stitch client accounts (Partners only)
-
Access Stitch client accounts
-
Retrieve configuration info for destinations
-
Create, update, and delete destinations
-
Retrieve configuration info for data sources
-
Create, update, pause, unpause, and delete data sources
-
Retrieve connection check results for a data source
-
Select and configure streams and fields from data sources for replication
-
Start and stop replication jobs
-
Create, pause, unpause, and delete notification settings for a Stitch client account
Check out the tutorials and resources to learn more about using Stitch Connect.
Accessing the API
To use the API, you’ll need to obtain an API access token. This is necessary for authenticating successfully. Refer to the Authentication section for more info.
Terminology
Partner |
An organization that utilizes Stitch Connect to programmatically create and/or manage Stitch client accounts on behalf of their users. |
Stitch client account |
An individual account for the Stitch web application. |
Destination |
Destination is the Stitch word for ‘data warehouse.’ A data warehouse is a central repository for data accumulated from a variety of sources. |
Session |
A browser session in the Stitch web application. |
Source |
A database, API, or other data application that Stitch replicates data from. Outside of Connect, known as an ‘integration’. |
Stream |
A table in a data source. |
Connection check |
A test performed by Stitch that checks the configuration of a source’s connection parameters. |
Replication job |
The three-step process by which Stitch replicates data. A replication job includes three distinct steps: Extraction, preparation, and loading. |
Structure sync |
The first step in the replication process, this process takes place during the Extraction phase of a replication job. A structure sync detects the tables and columns available in the source, along with any changes to the structure of those tables and columns. This is also referred to as discovery. |
Quick Start
Step 1: Obtain an access token
Stitch authenticates requests to the API using an API access token. How you obtain an access token depends on the type of user you are:
-
Individual Stitch user: You will be using the API to programmatically control your own Stitch client account. You can create, revoke, and delete API access tokens on the Account Settings page of your Stitch client account.
-
Stitch partner: You will be performing actions in Stitch client accounts on behalf of users who authorize your API client. You’ll need to register as an API client and refer to the Partner API Authentication guide for instructions.
After you obtain an API access token, it should be stored somewhere safe and passed into the header of every API request made for the Stitch client account. This token will never expire, but it may be revoked at any time.
Stitch account ownership:
Stitch client accounts are both owned and managed by the users themselves. For more info on authenticating with the API as a partner, refer to the Partner API Authentication guide.
Step 2: Make a test API request
To check that your access token is working correctly, send a test request to the Source Types endpoint and retrieve configuration info about the platform.hubspot
source:
curl -X GET https://api.stitchdata.com/v4/source-types/platform.hubspot
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
If successful, the API will return a status of 200 OK
and a Source Report Card object corresponding to platform.hubspot
.
Authentication
Authenticate your calls to the API by providing an access token in your requests. Each access token is associated with a single Stitch client account. Access tokens do not expire, but they may be revoked by the user at any time.
Additionally, each request’s permissions are limited to that Stitch client account.
In the examples in this documentation, we use bearer auth:
curl -X GET https://api.stitchdata.com/v4/sources
-H "Authorization: Bearer <ACCESS_TOKEN>"
All requests must be made over HTTPS or they will fail. API requests that don’t contain authentication will also fail.
Obtain an API access token
How you obtain an access token depends on the type of user you are:
-
Individual Stitch user: You will be using the API to programmatically control your own Stitch client account. You can create, revoke, and delete API access tokens on the Account Settings page of your Stitch client account.
-
Stitch partner: You will be performing actions in Stitch client accounts on behalf of users who authorize your API client. You’ll need to register as an API client and refer to the Partner API Authentication guide for instructions.
Response Codes
The API will attempt to return HTTP status codes for every request.
Code | Text | Description |
200 |
OK |
Success! |
400 |
Bad Request |
The request is invalid, contains malformed data, or otherwise cannot be served. The reasons for invalid requests can vary by endpoint. An accompanying message will provide detail about the reason for failure. |
401 |
Unauthorized |
The request doesn’t have a valid API access token. Verify your token is correct and re-try the request. |
404 |
Not Found |
Potential causes:
|
500 |
Internal Server Error |
The API is experiencing problems. Try again later. |
502 |
Bad Gateway |
The API is experiencing problems. Try again later. |
Error message format
The API will return error messages in JSON format. Some error messages may be returned as strings:
an account can have at most one destination
While others may be JSON objects:
{
"code":"ExistingUser",
"message":"This email address is already associated with an active user."
}
Error message text
The text in error messages will vary by root cause and endpoint.
Each endpoint section contains a rollup of the errors specific to that endpoint. Refer to the documentation for the endpoint for specifics on errors, their possible causes, and the messages the API will return.
Versioning
The API is currently versioned by object. The table below lists the core objects, all available versions, and the endpoints available for each version.
ACCOUNT | |
Version | Endpoints |
v3 (latest) | |
SESSION | |
Version | Endpoints |
v3 (latest) | |
DESTINATION TYPE | |
Version | Endpoints |
v4 (latest) | |
DESTINATION | |
Version | Endpoints |
v4 (latest) | |
v3 | |
SOURCE TYPE | |
Version | Endpoints |
v4 (latest) | |
SOURCE | |
Version | Endpoints |
v4 (latest) | |
CONNECTION CHECK | |
Version | Endpoints |
v4 (latest) | |
STREAM | |
Version | Endpoints |
v4 (latest) | |
REPLICATION JOB | |
Version | Endpoints |
v4 (latest) | |
NOTIFICATION | |
Version | Endpoints |
v1 (latest) |
|
Core Objects
Accounts
OBJECT | Account Object |
An object representing a Stitch client account. |
POST | Create an account |
Creates a new Stitch client account and receives an API access token in return. Note: This endpoint is available only to Stitch Partners. Before creating a Stitch account, you’ll need to request access to the API and obtain partner credentials by submitting this form to our team. |
The Account Object
An object representing a Stitch client account.
company
STRING |
A name for the Stitch client. This is typically the name of the company using the Stitch client account. |
email
STRING |
The email address of the user signing up for a Stitch client account. Upon successful account creation, Stitch will send an email to this address with instructions for completing the setup. |
first_name
STRING |
The first name of the user signing up for a Stitch client account. |
last_name
STRING |
The last name of the user signing up for a Stitch client account. |
partner_id
STRING |
The unique ID for your API client, obtained when you register to use the API. |
partner_secret
STRING |
The secret for your API client, obtained when you registered to use the API. |
Create an account
Creates a new Stitch client account and receives an API access token in return.
Note: This endpoint is available only to Stitch Partners. Before creating a Stitch account, you’ll need to request access to the API and obtain partner credentials by submitting this form to our team.
Resource List
Request Method |
POST |
Resource URL |
/v3/accounts |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
company
STRING REQUIRED |
A name for the Stitch client. This is typically the name of the company using the Stitch client account. |
email
STRING REQUIRED |
The email address of the user signing up for a Stitch client account. Upon successful account creation, Stitch will send an email to this address with instructions for completing the setup. |
first_name
STRING REQUIRED |
The first name of the user signing up for a Stitch client account. |
last_name
STRING REQUIRED |
The last name of the user signing up for a Stitch client account. |
partner_id
STRING REQUIRED |
The unique ID for your API client, obtained when you register to use the API. |
partner_secret
STRING REQUIRED |
The secret for your API client, obtained when you registered to use the API. |
Returns
If successful, the API will return a status of 200 OK
and an object with access_token
and stitch_account_id
properties.
Otherwise, an error will be returned. For example: If a Stitch client account associated with the user already exists, the request will return This email address is already associated with an active user.
See the Errors tab below for additional possibilities.
curl -X POST https://api.stitchdata.com/v3/accounts
-H "Content-Type: application/json"
-d "{
"partner_id": "<PARTNER_ID>",
"partner_secret": "<PARTNER_SECRET>",
"first_name": "Stitch",
"last_name": "Product Team",
"company": "Stitch Product Team",
"email": "stitch-api-test@stitchdata.com"
}"
{
"access_token": "at_<ACCESS_TOKEN>",
"stitch_account_id": 136715
}
Code | Condition | Response Body |
400 |
A Stitch account is already associated with the provided email address. |
|
400 |
Request body contains malformed data. |
|
400 |
Missing or invalid |
|
400 |
Missing or invalid |
|
Sessions
OBJECT | Session Object |
This object represents a browser session in the Stitch web application. |
POST | Create a session |
Generates an ephemeral token to create a session in the Stitch web application. Ephemeral tokens expire after one hour. |
The Session Object
This object represents a browser session in the Stitch web application.
ephemeral_token
STRING |
A token that is passed to the Connect JavaScript Client to create a session. |
Create a session
Generates an ephemeral token to create a session in the Stitch web application. Ephemeral tokens expire after one hour.
Ephemeral tokens are used to create a session with the Connect JavaScript client. The session will be for the user for whom the API access token was created.
After the ephemeral token is used to create a session, the created session will expire once terminated or after 12 hours.
Resource List
Request Method |
POST |
Resource URL |
/v3/sessions/ephemeral |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and a Session object.
curl -X POST https://api.stitchdata.com/v3/sessions/ephemeral
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
{
"ephemeral_token":"<EPHEMERAL_TOKEN>"
}
Destination Types
OBJECT | Destination Type Object |
The Destination Type object contains the information needed to configure a destination. |
GET | Get a destination type |
Retrieves general information about the configuration required for a destination type. |
GET | List all destination types |
Retrieves general information about the configuration required for all supported destination types. |
The Destination Type Object
The Destination Type object contains the information needed to configure a destination.
report_card
OBJECT (DESTINATION REPORT CARD) |
The destination Report Card object corresponding to the destination’s |
Get a destination type
Retrieves general information about the configuration required for a destination type.
Note: This endpoint doesn’t retrieve information about the specific configuration of a destination in a single account. Instead, it will return general configuration information for the specified destination type
.
To retrieve specific information about the destination for an account, use the List Destinations endpoint.
Resource List
Request Method |
GET |
Resource URL |
/v4/destination-types/{destination_type} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
destination_type
STRING REQUIRED |
A path parameter indicating the |
Returns
If successful, the API will return a status of 200 OK
and a Destination Report Card object corresponding to type
.
curl -X GET https://api.stitchdata.com/v4/destination-types/redshift
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"type": "redshift",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": false
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"protocol": "redshift",
"access": true
}
}
List all destination types
Retrieves general information about the configuration required for all supported destination types.
Note: This endpoint doesn’t retrieve information about the specific configuration of a destination in a single account. Instead, it will return general configuration information for all supported destination types.
To retrieve specific information about the destination for an account, use the List Destinations endpoint.
Resource List
Request Method |
GET |
Resource URL |
/v4/destination-types |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and an array of Destination Report Card objects, one for each supported destination type
.
curl -X GET https://api.stitchdata.com/v4/destination-types
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
[
{
"type": "azure_sqldw",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "azure_storage_account_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "azure_storage_sas_url",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false
},
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": false
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "beta",
"protocol": "azure_sqldw",
"access": true
}
},
{
"type": "redshift",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": false
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"protocol": "redshift",
"access": true
}
},
{
"type": "postgres",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": false
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "ssl",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "boolean"
},
"provided": false
},
{
"name": "sslrootcert",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"protocol": "postgres",
"access": true
}
},
{
"type": "snowflake",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "role",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "warehouse",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"protocol": "snowflake",
"access": true
}
},
{
"type": "s3",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "csv_delimiter",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "csv_force_quote",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false
},
{
"name": "output_file_format",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(csv|jsonl)$"
},
"provided": false
},
{
"name": "s3_bucket",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "s3_key_format_string",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "sentinel_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string",
"pattern": "^stitch-challenge-file-.*$"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"protocol": "s3",
"access": true
}
},
{
"type": "storagegrid",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "access_key_id",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "csv_delimiter",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "csv_force_quote",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false
},
{
"name": "endpoint",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "output_file_format",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(csv|jsonl)$"
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "s3_bucket",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "s3_key_format_string",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "secret_access_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "sentinel_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string",
"pattern": "^stitch-challenge-file-.*$"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "enterprise",
"pipeline_state": "alpha",
"protocol": "storagegrid",
"access": false
}
}
]
Destinations
OBJECT | Destination Object |
An object representing a destination. Destinations are the data warehouses into which Stitch writes data. |
POST | Create a destination |
Creates a new destination. Only a single destination is supported per Stitch client account. |
PUT | Update a destination |
Updates an existing destination. Modifications to the |
GET | List destinations |
Lists the destination currently in use for a Stitch account. Only a single data warehouse is supported per Stitch client account. |
DELETE | Delete a destination |
Deletes an existing destination. Note: Stitch requires a destination to replicate data. Replication will be paused until a new destination is created and has a successful connection. |
The Destination Object
An object representing a destination. Destinations are the data warehouses into which Stitch writes data.
created_at
TIMESTAMP |
The time at which the destination object was created. |
deleted_at
TIMESTAMP |
The time at which the destination object was deleted. |
id
INTEGER |
A unique identifier for this destination. |
name
STRING |
The name for the destination. |
paused_at
TIMESTAMP |
If the connection was paused by the user, the time the pause began. Otherwise, or if the connection is active, this will be null. |
properties
OBJECT (DESTINATION FORM PROPERTIES) |
Parameters for connecting to the destination, excluding any sensitive credentials. The parameters must adhere to the Note: When included in responses, this object will contain the current values for the destination’s form properties. If an optional property ( |
report_card
OBJECT (DESTINATION REPORT CARD) |
The Report Card object corresponding to the destination’s |
stitch_client_id
INTEGER |
The ID of the Stitch client account. |
system_paused_at
TIMESTAMP |
If the connection was paused by the system, the time the pause began. Otherwise, or if the connection is active, this will be null. |
type
STRING |
The destination type. Must be one of:
|
updated_at
TIMESTAMP |
The time at which the destination object was last updated. |
connection
OBJECT (DESTINATION FORM PROPERTIES) |
Parameters for connecting to the destination, excluding any sensitive credentials. The parameters must adhere to the type of destination. Note: This has been renamed to |
created_at
TIMESTAMP |
The time at which the destination object was created. |
id
INTEGER |
A unique identifier for this destination. |
last_check
TIMESTAMP |
The time the last connection check to the destination completed. Note: This field has been deprecated in v4 of the Destinations endpoint. |
type
STRING |
The destination type. Must be one of:
|
updated_at
TIMESTAMP |
The time at which the destination object was last updated. |
Create a destination
Creates a new destination. Only a single destination is supported per Stitch client account.
Resource List
Request Method |
POST |
Resource URL |
/v4/destinations |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
type
STRING REQUIRED |
The destination type. Must be one of:
|
properties
OBJECT REQUIRED |
A Destination Form Properties object corresponding to the value of |
Returns
If successful, the API will return a status of 200 OK
and a Destination object with a report_card
property.
The report_card
property contains the Destination Report Card object for the destination’s configuration status.
Create a PostgreSQL destination:
curl -X POST https://api.stitchdata.com/v4/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"postgres",
"properties": {
"host":"<HOST>",
"port":"5432",
"username":"stitch",
"database":"demni2mf59dt10",
"password":"<PASSWORD>",
"ssl":false
}
}"
PostgreSQL destination response:
{
"properties": {
"database": "demni2mf59dt10",
"encryption_type": "none",
"host": "<HOST>",
"port": "5432",
"ssl": "true",
"status": "1",
"username": "stitch"
},
"updated_at": "2019-05-24T18:04:08Z",
"name": "Default Warehouse",
"type": "postgres",
"deleted_at": null,
"system_paused_at": null,
"stitch_client_id": 116078,
"paused_at": null,
"id": 155582,
"display_name": null,
"created_at": "2019-05-24T18:03:50Z",
"report_card": {
"type": "postgres",
"current_step": 2,
"current_step_type": "fully_configured",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": true
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": true
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": true
},
{
"name": "ssl",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "boolean"
},
"provided": true
},
{
"name": "sslrootcert",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true
}
]
},
{
"type": "fully_configured",
"properties": []
}
]
}
}
Code | Condition | Response Body |
400 |
Accounts can have one destination |
|
400 |
Missing or prohibited arguments |
|
Outdated endpoint version
This isn’t the most current version of the Destinations endpoint and will be deprecated in the future. Use the v4 version instead.
Resource List
Request Method |
POST |
Resource URL |
/v3/destinations |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
type
STRING REQUIRED |
The destination type. Must be one of:
|
connection
OBJECT REQUIRED |
A Destination Form Properties object corresponding to the value of |
Returns
If successful, the API will return a status of 200 OK
and a Destination object.
Create an Amazon S3 destination:
curl -X POST https://api.stitchdata.com/v3/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"s3",
"connection": {
"s3_bucket":"com-stitch-test-bucket",
"output_file_format":"csv",
"s3_key_format_string":"[integration_name]/[table_name]/[table_version]_[timestamp_loaded].csv",
"csv_delimiter":",",
"csv_force_quote":true
}
}"
Create an Amazon Redshift destination:
curl -X POST https://api.stitchdata.com/v3/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"redshift",
"connection": {
"host":"<HOST>",
"port":5439,
"username":"<USERNAME>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"ssl":false
}
}"
Create a PostgreSQL destination:
curl -X POST https://api.stitchdata.com/v3/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"postgres",
"connection": {
"host":"<HOST>",
"port":5432,
"username":"<USERNAME>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"ssl":false
}
}"
Create a Snowflake destination:
curl -X POST https://api.stitchdata.com/v3/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"snowflake",
"connection": {
"host":"<HOST>",
"port":443,
"user":"<USERNAME>",
"warehouse":"<WAREHOUSE>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"role":"<OPTIONAL_ROLE>",
"ssl":false
}
}"
Amazon S3 destination response:
Note: There are additional steps to creating an Amazon S3 destination beyond submitting a successful request to this endpoint. Refer to the Amazon S3 Destination Form Property documentation for more info.
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
{
"id":"<DESTINATION_ID>",
"type":"s3",
"created_at":"2018-02-06T15:36:36Z",
"updated_at":"2018-02-06T15:36:36Z",
"connection": {
"s3_bucket":"com-stitch-test-bucket",
"output_file_format":"csv",
"s3_key_format_string":"[integration_name]/[table_name]/[table_version]_[timestamp_loaded].csv",
"csv_delimiter":",",
"csv_force_quote":true,
"sentinel_key":"stitch-challenge-file-af295ad1-7a4b-4881-89dc-c9be27de13a5"
},
"last_check":{
"error":false,
"started_at":"2018-02-06T16:15:19Z",
"completed_at":"2018-02-06T16:16:21Z"
}
}
Amazon Redshift destination response:
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
{
"id":"<DESTINATION_ID>",
"type":"redshift",
"created_at":"2018-02-06T15:36:36Z",
"updated_at":"2018-02-06T15:36:36Z",
"connection": {
"host":"<HOST>",
"port":5439,
"username":"<USERNAME>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"ssl":false
},
"last_check":{
"error":false,
"started_at":"2018-02-06T16:15:19Z",
"completed_at":"2018-02-06T16:16:21Z"
}
}
PostgreSQL destination response:
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
{
"id":"<DESTINATION_ID>",
"type":"postgres",
"created_at":"2018-02-06T15:36:36Z",
"updated_at":"2018-02-06T15:36:36Z",
"connection": {
"host":"<HOST>",
"port":5432,
"username":"<USERNAME>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"ssl":false
},
"last_check":{
"error":false,
"started_at":"2018-02-06T16:15:19Z",
"completed_at":"2018-02-06T16:16:21Z"
}
}
Snowflake destination response:
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
{
"id":"<DESTINATION_ID>",
"type":"snowflake",
"created_at":"2018-02-06T15:36:36Z",
"updated_at":"2018-02-06T15:36:36Z",
"connection": {
"host":"<HOST>",
"port":443,
"user":"<USERNAME>",
"warehouse":"<WAREHOUSE>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"role":"<OPTIONAL_ROLE>",
"ssl":false
},
"last_check":{
"error":false,
"started_at":"2018-02-06T16:15:19Z",
"completed_at":"2018-02-06T16:16:21Z"
}
}
Code | Condition | Response Body |
400 |
Accounts can have one destination |
|
400 |
Missing or prohibited arguments |
|
Update a destination
Updates an existing destination. Modifications to the type
attribute are not supported.
Resource List
Request Method |
PUT |
Resource URL |
/v4/destinations/{destination_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
destination_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the destination to be updated. |
properties
OBJECT REQUIRED |
A Destination Form Properties object corresponding to the value of |
Returns
If successful, the API will return a status of 200 OK
and a Destination object with a report_card
property.
curl -X PUT https://api.stitchdata.com/v4/destinations/155582
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"properties": {
"username": "stitch_admin"
}
}"
{
"properties": {
"database": "demni2mf59dt10",
"encryption_type": "none",
"host": "<HOST>",
"port": "5432",
"ssl": "true",
"status": "1",
"username": "stitch_admin"
},
"updated_at": "2019-05-28T15:37:37Z",
"check_job_name": "116078.155582.check.859f4746-815e-11e9-bb8e-0693226a5168",
"name": "Default Warehouse",
"type": "postgres",
"deleted_at": null,
"system_paused_at": null,
"stitch_client_id": 116078,
"paused_at": null,
"id": 155582,
"display_name": null,
"created_at": "2019-05-24T18:03:50Z",
"report_card": {
"type": "postgres",
"current_step": 2,
"current_step_type": "fully_configured",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": true
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": true
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": true
},
{
"name": "ssl",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "boolean"
},
"provided": true
},
{
"name": "sslrootcert",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true
}
]
},
{
"type": "fully_configured",
"properties": []
}
]
}
}
Code | Condition | Response Body |
400 |
Modifications to |
|
400 |
Invalid destination ID |
|
Outdated endpoint version
This isn’t the most current version of the Destinations endpoint and will be deprecated in the future. Use the v4 version instead.
Resource List
Request Method |
PUT |
Resource URL |
/v3/destinations/{destination_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
destination_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the destination to be updated. |
type
STRING REQUIRED |
The destination type. Must be one of:
|
connection
OBJECT REQUIRED |
A Destination Form Properties object corresponding to the value of |
Returns
If successful, the API will return a status of 200 OK
and a Destination object.
curl -X PUT https://api.stitchdata.com/v3/destinations/86741
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"postgres",
"connection": {
"host": "<HOST>",
"port": 5432,
"username": "<USERNAME>",
"database": "<DATABASE>",
"password": "<PASSWORD>",
"ssl": false
}
}"
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
{
"id":"<DESTINATION_ID>",
"type":"postgres",
"created_at":"2018-02-06T15:36:36Z",
"updated_at":"2018-02-06T18:55:43Z",
"connection": {
"host":"<HOST>",
"port":5432,
"username":"<USERNAME>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"ssl":false
},
"last_check":{
"error": false,
"started_at":"2018-02-06T16:15:19Z",
"completed_at":"2018-02-06T16:16:21Z"
}
}
Code | Condition | Response Body |
400 |
Modifications to |
|
400 |
Invalid destination ID |
|
List destinations
Lists the destination currently in use for a Stitch account. Only a single data warehouse is supported per Stitch client account.
Resource List
Request Method |
GET |
Resource URL |
/v4/destinations |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and an array of Destination objects, one for each destination connected to the account.
Note: Stitch currently supports only one destination per account.
curl -X GET https://api.stitchdata.com/v4/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
[
{
"properties":{
"database":"demni2mf59dt10",
"encryption_type":"none",
"host":"<HOST>",
"port":"5432",
"ssl":"true",
"status":"1",
"username":"stitch"
},
"updated_at":"2019-05-24T18:04:08Z",
"name":"Default Warehouse",
"type":"postgres",
"deleted_at":null,
"system_paused_at":null,
"stitch_client_id":116078,
"paused_at":null,
"id":155582,
"display_name":null,
"created_at":"2019-05-24T18:03:50Z",
"report_card":{
"type":"postgres",
"current_step":2,
"current_step_type":"fully_configured",
"steps":[
{
"type":"form",
"properties":[
{
"name":"database",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true
},
{
"name":"encryption_host",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"anyOf":[
{
"type":"string",
"format":"ipv4"
},
{
"type":"string",
"format":"ipv6"
},
{
"type":"string",
"format":"hostname"
}
]
},
"provided":false
},
{
"name":"encryption_port",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d+$"
},
"provided":false
},
{
"name":"encryption_type",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^(ssh|none)$"
},
"provided":true
},
{
"name":"encryption_username",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":false
},
{
"name":"host",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"anyOf":[
{
"type":"string",
"format":"ipv4"
},
{
"type":"string",
"format":"ipv6"
},
{
"type":"string",
"format":"hostname"
}
]
},
"provided":true
},
{
"name":"password",
"is_required":true,
"is_credential":true,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true
},
{
"name":"port",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d+$"
},
"provided":true
},
{
"name":"ssl",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"boolean"
},
"provided":true
},
{
"name":"sslrootcert",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":false
},
{
"name":"username",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true
}
]
},
{
"type":"fully_configured",
"properties":[
]
}
]
}
}
]
Outdated endpoint version
This isn’t the most current version of the Destinations endpoint and will be deprecated in the future. Use the v4 version instead.
Resource List
Request Method |
GET |
Resource URL |
/v3/destinations |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and an array (of length zero or one) of Destination objects.
curl -X GET https://api.stitchdata.com/v3/destinations
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
[
{
"id":"<DESTINATION_ID>",
"type":"redshift",
"created_at":"2018-02-06T15:36:36Z",
"updated_at":"2018-02-06T15:36:36Z",
"connection": {
"host":"<HOST>",
"port":5439,
"username":"<USERNAME>",
"database":"<DATABASE>",
"password":"<PASSWORD>",
"ssl":false
},
"last_check":{
"error": false,
"started_at":"2018-02-06T16:15:19Z",
"completed_at":"2018-02-06T16:16:21Z"
}
}
]
Delete a destination
Deletes an existing destination.
Note: Stitch requires a destination to replicate data. Replication will be paused until a new destination is created and has a successful connection.
Resource List
Request Method |
DELETE |
Resource URL |
/v4/destinations/{destination_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
destination_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the destination to be deleted. |
Returns
If successful, the API will return a status of 200 OK
and an empty body.
curl -X DELETE https://api.stitchdata.com/v4/destinations/155582
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{}
Code | Condition | Response Body |
400 |
Invalid destination ID |
May result from an incorrect destination ID, or if the destination has already been deleted. |
502 |
Destination ID not provided |
Occurs when a destination ID argument isn’t included in the request URL. Below is an incorrectly formatted request URL:
This is correct:
|
502 |
Destination ID contains illegal characters |
Occurs when a destination ID argument includes illegal characters, such as letters. For example:
|
Not available in this version
This method isn’t available in version 3 of the Destinations endpoint. Use the v4 version to use this method.
Source Types
OBJECT | Source Type Object |
The Source Type object contains the information needed to configure a data source. |
GET | Get a source type |
Retrieves general information about the configuration required for a data source type. |
GET | List all source types |
Retrieves general information about the configuration required for all supported data source types. |
The Source Type Object
The Source Type object contains the information needed to configure a data source.
report_card
OBJECT (SOURCE REPORT CARD) |
The Source Report Card object corresponding to the source’s |
Get a source type
Retrieves general information about the configuration required for a data source type.
Note: This endpoint doesn’t retrieve information about the specific configuration of sources in a single account. Instead, it will return general configuration information for the specified source source_type
.
To retrieve information about a specific data source, use the Get a Source endpoint.
Resource List
Request Method |
GET |
Resource URL |
/v4/source-types/{source_type} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_type
STRING REQUIRED |
A path parameter indicating the |
Returns
If successful, the API will return a status of 200 OK
and a Source Report Card object corresponding to type
.
curl -X GET https://api.stitchdata.com/v4/source-types/platform.hubspot
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"type": "platform.hubspot",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "redirect_uri",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-30 days",
"protocol": "platform.hubspot",
"access": true
}
}
List all source types
Retrieves general information about the configuration required for all supported data source types.
Note: This endpoint doesn’t retrieve information about the specific configuration of sources in a single account. Instead, it will return general configuration information for all supported source types.
To retrieve specific information about all data sources for an account, use the List Sources endpoint.
Resource List
Request Method |
GET |
Resource URL |
/v4/source-types |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and an array of Source Report Card objects, one for each supported source type
.
curl -X GET https://api.stitchdata.com/v4/source-types
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
[
{
"type": "platform.closeio",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_start_date": "-1 year",
"default_scheduling_interval": 30,
"protocol": "platform.closeio",
"access": true
}
},
{
"type": "platform.hubspot",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "redirect_uri",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-30 days",
"protocol": "platform.hubspot",
"access": true
}
},
{
"type": "platform.marketo",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "endpoint",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "identity",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "max_daily_calls",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "deprecated",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.marketo",
"access": false
}
},
{
"type": "platform.facebook",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "aggregate_level",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "attribution_window",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "include_deleted",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "insights_buffer_days",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "access_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "account_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.facebook",
"access": true
}
},
{
"type": "platform.adwords",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "customer_ids",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "developer_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user_id",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 1440,
"default_start_date": "-1 year",
"protocol": "platform.adwords",
"access": true
}
},
{
"type": "platform.zuora",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_type",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(AQUA|REST)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "european",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "partner_id",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "sandbox",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "username",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.zuora",
"access": true
}
},
{
"type": "platform.mysql",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "allow_non_auto_increment_pks",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "check_hostname",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "database",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_dbs",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "server_id",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_ca",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_cert",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_client_auth_enabled",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_key",
"is_required": false,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "use_log_based_replication",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "verify_mode",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": null,
"protocol": "platform.mysql",
"access": true
}
},
{
"type": "platform.fullstory",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.fullstory",
"access": true
}
},
{
"type": "platform.aurora",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "allow_non_auto_increment_pks",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "database",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "server_id",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "use_log_based_replication",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": null,
"protocol": "platform.mysql",
"access": true
}
},
{
"type": "platform.mariadb",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "allow_non_auto_increment_pks",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "database",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "server_id",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "use_log_based_replication",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": null,
"protocol": "platform.mysql",
"access": true
}
},
{
"type": "platform.cloudsql",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "allow_non_auto_increment_pks",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "check_hostname",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "database",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "internal_hostname",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "server_id",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_ca",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_cert",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_client_auth_enabled",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_key",
"is_required": false,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "use_log_based_replication",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "verify_mode",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": null,
"protocol": "platform.mysql",
"access": true
}
},
{
"type": "platform.xero",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "consumer_key",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "consumer_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_s3_bucket",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_s3_path",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_session_handle",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_token_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "organization_name",
"is_required": false,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "rsa_key",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "user_agent",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.xero",
"access": true
}
},
{
"type": "platform.jira",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "base_url",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.jira",
"access": true
}
},
{
"type": "platform.salesforce",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(REST|BULK)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "is_sandbox",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "quota_percent_per_run",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "quota_percent_total",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "select_fields_by_default",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "instance_url",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false,
"tap_mutable": false
},
{
"name": "orgid",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.salesforce",
"access": true
}
},
{
"type": "platform.pipedrive",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.pipedrive",
"access": true
}
},
{
"type": "platform.marketobulk",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "endpoint",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "max_daily_calls",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "max_export_days",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 720,
"default_start_date": "-1 year",
"protocol": "platform.marketo",
"access": true
}
},
{
"type": "platform.listrak",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.listrak",
"access": true
}
},
{
"type": "platform.bing-ads",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "account_ids",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "customer_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "developer_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "oauth_client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user_id",
"is_required": false,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 1440,
"default_start_date": "-1 year",
"protocol": "platform.bing-ads",
"access": true
}
},
{
"type": "platform.yotpo",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.yotpo",
"access": true
}
},
{
"type": "platform.sendgrid",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.sendgrid",
"access": true
}
},
{
"type": "platform.quickbase",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "qb_appid",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "qb_url",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "qb_user_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.quickbase",
"access": true
}
},
{
"type": "platform.oracle",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "default_replication_method",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(LOG_BASED|FULL_TABLE)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_schemas",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "sid",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "enterprise",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": null,
"protocol": "platform.oracle",
"access": false
}
},
{
"type": "platform.bronto",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.bronto",
"access": true
}
},
{
"type": "platform.postgres",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "dbname",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "debug_lsn",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "default_replication_method",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_dbs",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "include_schemas_in_destination_stream_name",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "itersize",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "logical_poll_total_seconds",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "use_log_based_replication",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": null,
"protocol": "platform.postgres",
"access": true
}
},
{
"type": "platform.github",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "access_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "repository",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.github",
"access": true
}
},
{
"type": "platform.zendesk",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "subdomain",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "access_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.zendesk",
"access": true
}
},
{
"type": "platform.s3-csv",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "account_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "bucket",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "external_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "role_name",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "search_prefix",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "tables",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.s3-csv",
"access": true
}
},
{
"type": "platform.doubleclick-campaign-manager",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "profile_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.doubleclick-campaign-manager",
"access": true
}
},
{
"type": "platform.amplitude",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "account",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "warehouse",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": null,
"protocol": "platform.amplitude",
"access": true
}
},
{
"type": "platform.uservoice",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "subdomain",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.uservoice",
"access": true
}
},
{
"type": "platform.heroku_pg",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "dbname",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "default_replication_method",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_dbs",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "include_schemas_in_destination_stream_name",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "itersize",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": null,
"protocol": "platform.postgres",
"access": true
}
},
{
"type": "platform.cloudsql_pg",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "dbname",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "default_replication_method",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_dbs",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "include_schemas_in_destination_stream_name",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "itersize",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": null,
"protocol": "platform.postgres",
"access": true
}
},
{
"type": "platform.harvest-forecast",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "account_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.harvest-forecast",
"access": true
}
},
{
"type": "platform.campaign-monitor",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "access_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.campaign-monitor",
"access": true
}
},
{
"type": "platform.platformpurple",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "environment",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.platformpurple",
"access": true
}
},
{
"type": "platform.clubspeed",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "private_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "subdomain",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.clubspeed",
"access": true
}
},
{
"type": "platform.shopify",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "date_window_size",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "shop",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.shopify",
"access": true
}
},
{
"type": "import_api",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": null,
"protocol": "import_api",
"access": true
}
},
{
"type": "platform.responsys",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "path",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.responsys",
"access": true
}
},
{
"type": "platform.stripe",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "date_window_size",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "whitelist_map",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "account_id",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-1 year",
"protocol": "platform.stripe",
"access": true
}
},
{
"type": "platform.heap",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "account_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "bucket",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "external_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "role_name",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.heap",
"access": true
}
},
{
"type": "platform.frontapp",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "incremental_range",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.frontapp",
"access": true
}
},
{
"type": "platform.revinate",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.revinate",
"access": true
}
},
{
"type": "platform.typeform",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "forms",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "incremental_range",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.typeform",
"access": true
}
},
{
"type": "platform.toggl",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "detailed_report_trailing_days",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.toggl",
"access": true
}
},
{
"type": "platform.eloqua",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "bulk_page_size",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "redirect_uri",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": true
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "beta",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.eloqua",
"access": true
}
},
{
"type": "platform.shiphero",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "beta",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.shiphero",
"access": true
}
},
{
"type": "platform.netsuite",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "account",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "consumer_key",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "consumer_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "page_size",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "token_id",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "token_secret",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.netsuite",
"access": true
}
},
{
"type": "platform.bigcommerce",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "access_token",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "store_hash",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.bigcommerce",
"access": true
}
{
"type": "platform.onfleet",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "quota_limit",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "beta",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.onfleet",
"access": true
}
},
{
"type": "platform.invoiced",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "sandbox",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.invoiced",
"access": true
}
},
{
"type": "platform.chargebee",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "api_key",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "site",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "beta",
"default_scheduling_interval": 60,
"default_start_date": "-1 year",
"protocol": "platform.chargebee",
"access": true
}
}
]
Sources
OBJECT | Source Object |
An object representing a data source. Sources are the databases, APIs, and other data applications that Stitch replicates data from. Sources can be retrieved in a list or individually by ID. |
POST | Create a source |
Creates a source object, which is the first step in setting up a new data source. |
PUT | Update a source |
Updates an existing data source. |
PUT | Pause a source |
Pauses an existing data source. |
PUT | Unpause a source |
Unpauses a previously paused data source. |
GET | Retrieve a source |
Retrieves a previously created data source by its unique identifier. |
GET | List all sources |
Lists the sources for an account, including active, paused, and deleted sources. |
DELETE | Delete a source |
Deletes an existing data source. |
The Source Object
An object representing a data source. Sources are the databases, APIs, and other data applications that Stitch replicates data from. Sources can be retrieved in a list or individually by ID.
id
INTEGER |
The unique identifier for this source. |
created_at
TIMESTAMP |
The time at which the source object was created. |
deleted_at
TIMESTAMP |
The time at which the source object was deleted. |
display_name
STRING |
The display name of the source connection. |
name
STRING |
The name of the source connection, dynamically generated from Names must:
|
paused_at
TIMESTAMP |
If the connection was paused by the user, the time the pause began. Otherwise, or if the connection is active, this will be `null. |
properties
OBJECT (SOURCE FORM PROPERTIES) |
Parameters for connecting to the source, excluding any sensitive credentials. The parameters must adhere to the Note: When included in responses, this object will contain the current values for the source’s form properties. If an optional property ( |
report_card
OBJECT (SOURCE REPORT CARD) |
A description of the source’s configuration state. |
stitch_client_id
INTEGER |
The ID of the Stitch client account. |
system_paused_at
TIMESTAMP |
If the connection was paused by the system, the time the pause began. Otherwise, or if the connection is active, this will be null. |
type
STRING |
The source type. |
updated_at
TIMESTAMP |
The time at which the object was last updated. |
Create a source
Creates a source object, which is the first step in setting up a new data source. After the source object is created, additional configuration steps must be completed.
The configuration process is unique for each type of source. The report_card
object’s steps
attribute will assist you in guiding the user to the Connect JavaScript Client to complete the appropriate step.
Resource List
Request Method |
POST |
Resource URL |
/v4/sources |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
display_name
STRING REQUIRED |
A descriptive name for the source. This will be used to dynamically generate the name corresponding to the schema name or dataset name that the data from this source will be loaded into. |
type
STRING REQUIRED |
The source type. For example: |
properties
OBJECT OPTIONAL |
A source Properties object corresponding to the value of |
Returns
If successful, the API will return a status of 200 OK
and a Source object with a report_card
property.
The report_card
property contains the Source Report Card object for the source’s configuration status.
curl -X POST https://api.stitchdata.com/v4/sources
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"platform.shopify",
"display_name":"Shopify",
"properties":{
"start_date":"2017-01-01T00:00:00Z",
"frequency_in_minutes":"30"
}
}"
{
"properties":{
"anchor_time":"2019-01-30T18:16:37.205Z",
"cron_expression":null,
"frequency_in_minutes":"30",
"image_version":"1.latest",
"product":"pipeline",
"shop":"stitchdatawearhouse",
"start_date":"2017-01-01T00:00:00Z"
},
"updated_at":"2019-05-28T13:52:23Z",
"schedule":null,
"name":"shopify",
"type":"platform.shopify",
"deleted_at":null,
"system_paused_at":null,
"stitch_client_id":116078,
"paused_at":null,
"id":86741,
"display_name":"Shopify",
"created_at":"2019-01-10T19:38:18Z",
"report_card":{
"type":"platform.shopify",
"current_step":1,
"current_step_type":"fully_configured",
"steps":[
{
"type":"form",
"properties":[
{
"name":"anchor_time",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"format":"date-time"
},
"provided":true,
"tap_mutable":false
},
{
"name":"cron_expression",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":null,
"provided":false,
"tap_mutable":false
},
{
"name":"date_window_size",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"integer"
},
"provided":false,
"tap_mutable":false
},
{
"name":"frequency_in_minutes",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided":true,
"tap_mutable":false
},
{
"name":"image_version",
"is_required":true,
"is_credential":false,
"system_provided":true,
"property_type":"read_only",
"json_schema":null,
"provided":true,
"tap_mutable":false
},
{
"name":"shop",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true,
"tap_mutable":false
},
{
"name":"start_date",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided":true,
"tap_mutable":false
}
]
},
{
"type":"oauth",
"properties":[
{
"name":"api_key",
"is_required":true,
"is_credential":true,
"system_provided":true,
"property_type":"system_provided_by_default",
"json_schema":{
"type":"string"
},
"provided":false,
"tap_mutable":false
}
]
},
{
"type":"discover_schema",
"properties":[
]
},
{
"type":"field_selection",
"properties":[
]
},
{
"type":"fully_configured",
"properties":[
]
}
]
}
}
Code | Condition | Response Body |
400 |
Invalid source |
|
400 |
Source’s |
|
400 |
Prohibited arguments |
|
400 |
Invalid |
|
400 |
Non-unique name property |
|
400 |
Invalid name property |
|
400 |
Insufficient access to source type |
|
400 |
Invalid |
May result from incorrect formatting, incorrect data typing, or a property has a value that is an empty string. |
400 |
Insufficient account access to cron scheduling feature |
|
400 |
Cron expressions can’t specify both a day-of-week and day-of-month |
|
Update a source
Updates an existing data source.
Resource List
Request Method |
PUT |
Resource URL |
/v4/sources/{source_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source to be updated. |
display_name
STRING OPTIONAL |
A descriptive name for the source. This will be used to dynamically generate the name corresponding to the schema name or dataset name that the data from this source will be loaded into. |
paused_at
TIMESTAMP OPTIONAL |
The time the source was paused. This field must contain an ISO 8601-compliant date. Note: Providing any value - past, present, or future - for this property will pause the source immediately if the request is successful. Refer to the Pause a source reference for request and response examples. |
properties
OBJECT OPTIONAL |
A source Properties object corresponding to the value of |
Returns
If successful, the API will return a status of 200 OK
and a Source object.
curl -X PUT https://api.stitchdata.com/v4/sources/86741
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"display_name":"Shopify",
"properties":{
"frequency_in_minutes":"60"
}
}"
{
"properties":{
"anchor_time":"2019-01-30T18:16:37.205Z",
"cron_expression":null,
"frequency_in_minutes":"60",
"image_version":"1.latest",
"product":"pipeline",
"shop":"stitchdatawearhouse",
"start_date":"2017-01-01T00:00:00Z"
},
"updated_at":"2019-05-28T13:52:23Z",
"schedule":null,
"name":"shopify",
"type":"platform.shopify",
"deleted_at":null,
"system_paused_at":null,
"stitch_client_id":116078,
"paused_at":null,
"id":86741,
"display_name":"Shopify",
"created_at":"2019-01-10T19:38:18Z",
"report_card":{
"type":"platform.shopify",
"current_step":1,
"current_step_type":"fully_configured",
"steps":[
{
"type":"form",
"properties":[
{
"name":"anchor_time",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"format":"date-time"
},
"provided":true,
"tap_mutable":false
},
{
"name":"cron_expression",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":null,
"provided":false,
"tap_mutable":false
},
{
"name":"date_window_size",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"integer"
},
"provided":false,
"tap_mutable":false
},
{
"name":"frequency_in_minutes",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided":true,
"tap_mutable":false
},
{
"name":"image_version",
"is_required":true,
"is_credential":false,
"system_provided":true,
"property_type":"read_only",
"json_schema":null,
"provided":true,
"tap_mutable":false
},
{
"name":"shop",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true,
"tap_mutable":false
},
{
"name":"start_date",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided":true,
"tap_mutable":false
}
]
},
{
"type":"oauth",
"properties":[
{
"name":"api_key",
"is_required":true,
"is_credential":true,
"system_provided":true,
"property_type":"system_provided_by_default",
"json_schema":{
"type":"string"
},
"provided":false,
"tap_mutable":false
}
]
},
{
"type":"discover_schema",
"properties":[
]
},
{
"type":"field_selection",
"properties":[
]
},
{
"type":"fully_configured",
"properties":[
]
}
]
}
}
Code | Condition | Response Body |
400 |
Invalid |
May result from incorrect formatting, incorrect data typing, or a property has a value that is an empty string. |
400 |
Insufficient account access to cron scheduling feature |
|
400 |
Cron expressions can’t specify both a day-of-week and day-of-month |
|
400 |
Prohibited arguments |
|
400 |
Invalid display name |
|
400 |
Invalid source ID |
|
Pause a source
Pauses an existing data source. When a source is paused, Stitch will not automatically start replication jobs for the source. Manual replication jobs can still be started using the Start a replication job endpoint, however.
Note: This endpoint behaves identically to Update a source.
Resource List
Request Method |
PUT |
Resource URL |
/v4/sources/{source_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source to be paused. |
paused_at
TIMESTAMP OPTIONAL |
The time the source was paused. This field must contain an ISO 8601-compliant date. Note: Providing any value - past, present, or future - for this property will pause the source immediately if the request is successful. |
Returns
If successful, the API will return a status of 200 OK
and a Source object with a populated paused_at
value.
curl -X PUT https://api.stitchdata.com/v4/sources/86741
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"paused_at":"2019-06-01T00:00:00Z"
}"
{
"properties":{
"anchor_time":"2019-01-30T18:16:37.205Z",
"cron_expression":null,
"frequency_in_minutes":"60",
"image_version":"1.latest",
"product":"pipeline",
"shop":"stitchdatawearhouse",
"start_date":"2017-01-01T00:00:00Z"
},
"updated_at":"2019-05-28T13:52:23Z",
"schedule":null,
"name":"shopify",
"type":"platform.shopify",
"deleted_at":null,
"system_paused_at":null,
"stitch_client_id":116078,
"paused_at":"2019-06-01T00:00:00Z",
"id":86741,
"display_name":"Shopify",
"created_at":"2019-01-10T19:38:18Z",
"report_card":{
"type":"platform.shopify",
"current_step":1,
"current_step_type":"fully_configured",
"steps":[
{
"type":"form",
"properties":[
{
"name":"anchor_time",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"format":"date-time"
},
"provided":true,
"tap_mutable":false
},
{
"name":"cron_expression",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":null,
"provided":false,
"tap_mutable":false
},
{
"name":"date_window_size",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"integer"
},
"provided":false,
"tap_mutable":false
},
{
"name":"frequency_in_minutes",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided":true,
"tap_mutable":false
},
{
"name":"image_version",
"is_required":true,
"is_credential":false,
"system_provided":true,
"property_type":"read_only",
"json_schema":null,
"provided":true,
"tap_mutable":false
},
{
"name":"shop",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true,
"tap_mutable":false
},
{
"name":"start_date",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided":true,
"tap_mutable":false
}
]
},
{
"type":"oauth",
"properties":[
{
"name":"api_key",
"is_required":true,
"is_credential":true,
"system_provided":true,
"property_type":"system_provided_by_default",
"json_schema":{
"type":"string"
},
"provided":false,
"tap_mutable":false
}
]
},
{
"type":"discover_schema",
"properties":[
]
},
{
"type":"field_selection",
"properties":[
]
},
{
"type":"fully_configured",
"properties":[
]
}
]
}
}
Unpause a source
Unpauses a previously paused data source.
Note: This endpoint behaves identically to Update a source.
Resource List
Request Method |
PUT |
Resource URL |
/v4/sources/{source_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source to be paused. |
paused_at
NULL OPTIONAL |
To unpause a source, this value must be |
Returns
If successful, the API will return a status of 200 OK
and a Source object with a null
paused_at
value.
curl -X PUT https://api.stitchdata.com/v4/sources/86741
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"paused_at":null
}"
{
"properties":{
"anchor_time":"2019-01-30T18:16:37.205Z",
"cron_expression":null,
"frequency_in_minutes":"60",
"image_version":"1.latest",
"product":"pipeline",
"shop":"stitchdatawearhouse",
"start_date":"2017-01-01T00:00:00Z"
},
"updated_at":"2019-05-28T13:52:23Z",
"schedule":null,
"name":"shopify",
"type":"platform.shopify",
"deleted_at":null,
"system_paused_at":null,
"stitch_client_id":116078,
"paused_at":null,
"id":86741,
"display_name":"Shopify",
"created_at":"2019-01-10T19:38:18Z",
"report_card":{
"type":"platform.shopify",
"current_step":1,
"current_step_type":"fully_configured",
"steps":[
{
"type":"form",
"properties":[
{
"name":"anchor_time",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"format":"date-time"
},
"provided":true,
"tap_mutable":false
},
{
"name":"cron_expression",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":null,
"provided":false,
"tap_mutable":false
},
{
"name":"date_window_size",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"integer"
},
"provided":false,
"tap_mutable":false
},
{
"name":"frequency_in_minutes",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided":true,
"tap_mutable":false
},
{
"name":"image_version",
"is_required":true,
"is_credential":false,
"system_provided":true,
"property_type":"read_only",
"json_schema":null,
"provided":true,
"tap_mutable":false
},
{
"name":"shop",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true,
"tap_mutable":false
},
{
"name":"start_date",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided":true,
"tap_mutable":false
}
]
},
{
"type":"oauth",
"properties":[
{
"name":"api_key",
"is_required":true,
"is_credential":true,
"system_provided":true,
"property_type":"system_provided_by_default",
"json_schema":{
"type":"string"
},
"provided":false,
"tap_mutable":false
}
]
},
{
"type":"discover_schema",
"properties":[
]
},
{
"type":"field_selection",
"properties":[
]
},
{
"type":"fully_configured",
"properties":[
]
}
]
}
}
Retrieve a source
Retrieves a previously created data source by its unique identifier. This endpoint can be used to retrieve an active, paused, or deleted source.
Resource List
Request Method |
GET |
Resource URL |
/v4/sources/{source_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the data source to be retrieved. |
Returns
If successful and a valid identifier was provided, the API will return a status of 200 OK
and a single Source Object.
curl -X GET https://api.stitchdata.com/v4/sources/120643
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"properties": {
"anchor_time": "2019-01-07T23:23:08.116Z",
"cron_expression": null,
"customer_ids": "1585293495,4224806558,6668731595",
"frequency_in_minutes": "30",
"image_version": "1.latest",
"product": "pipeline",
"start_date": "2018-01-01T00:00:00Z",
"user_id": "100551921296891141132"
},
"updated_at": "2019-04-12T19:03:13Z",
"schedule": null,
"name": "adwords",
"type": "platform.adwords",
"deleted_at": "2019-01-09T17:28:57Z",
"system_paused_at": null,
"stitch_client_id": 116078,
"paused_at": null,
"id": 120643,
"display_name": "AdWords",
"created_at": "2019-01-07T23:20:22Z",
"report_card": {
"type": "platform.adwords",
"current_step": 5,
"current_step_type": "fully_configured",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": true,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": true,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "customer_ids",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "developer_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "user_id",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
]
}
}
List all sources
Lists the sources for an account, including active, paused, and deleted sources.
Note: This endpoint retrieves specific configuration information about the sources connected to a single account. To retrieve general configuration information about all supported data source types, use the List all source types endpoint.
Resource List
Request Method |
GET |
Resource URL |
/v4/sources |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and an array of Source Objects, one for each source connected to the account.
curl -X GET https://api.stitchdata.com/v4/sources
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
[
{
"properties": {
"anchor_time": "2019-01-07T23:23:08.116Z",
"cron_expression": null,
"customer_ids": "1585293495,4224806558,6668731595",
"frequency_in_minutes": "30",
"image_version": "1.latest",
"product": "pipeline",
"start_date": "2018-01-01T00:00:00Z",
"user_id": "100551921296891141132"
},
"updated_at": "2019-04-12T19:03:13Z",
"schedule": null,
"name": "adwords",
"type": "platform.adwords",
"deleted_at": "2019-01-09T17:28:57Z",
"system_paused_at": null,
"stitch_client_id": 116078,
"paused_at": null,
"id": 119945,
"display_name": "AdWords2",
"created_at": "2019-01-07T23:20:22Z",
"report_card": {
"type": "platform.adwords",
"current_step": 5,
"current_step_type": "fully_configured",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": true,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": true,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "customer_ids",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "developer_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "user_id",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
]
}
},
{
"properties": {
"anchor_time": "2019-01-09T19:30:00.000Z",
"user_agent": "Stitch-c7ad6999-c6d8-4504-9ae6-b153717fdd3e",
"oauth_s3_path": "116078-120407-xero",
"organization_name": "Stitch Xero",
"frequency_in_minutes": "60",
"product": "pipeline",
"oauth_s3_bucket": "com-stitchdata-prod-platform-oauth-creds",
"start_date": "2018-01-09T19:15:49Z",
"cron_expression": null,
"image_version": "1.latest"
},
"updated_at": "2019-05-24T16:21:57Z",
"schedule": null,
"name": "xero",
"type": "platform.xero",
"deleted_at": null,
"system_paused_at": null,
"stitch_client_id": 116078,
"paused_at": "2019-01-22T18:04:48Z",
"id": 120407,
"display_name": "Xero",
"created_at": "2019-01-09T19:16:03Z",
"report_card": {
"type": "platform.xero",
"current_step": 4,
"current_step_type": "field_selection",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": true,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": true,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "consumer_key",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "consumer_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_s3_bucket",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_s3_path",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_session_handle",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "oauth_token_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "organization_name",
"is_required": false,
"is_credential": false,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "rsa_key",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "user_agent",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
]
}
},
{
"properties": {
"ssl": "true",
"anchor_time": "2019-01-10T19:39:17.724Z",
"frequency_in_minutes": "60",
"port": "5432",
"dbname": "demni2mf59dt10",
"host": "<HOST>",
"product": "pipeline",
"cron_expression": null,
"image_version": "0.latest",
"user": "nxucqufdolmwxr"
},
"updated_at": "2019-05-24T19:54:43Z",
"schedule": null,
"name": "heroku",
"type": "platform.heroku_pg",
"deleted_at": "2019-05-24T19:54:43Z",
"system_paused_at": null,
"stitch_client_id": 116078,
"paused_at": null,
"id": 120643,
"display_name": "Heroku",
"created_at": "2019-01-10T19:36:13Z",
"report_card": {
"type": "platform.heroku_pg",
"current_step": 4,
"current_step_type": "fully_configured",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": true,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "dbname",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "default_replication_method",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_dbs",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": true,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": true,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": true,
"tap_mutable": false
},
{
"name": "include_schemas_in_destination_stream_name",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "itersize",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "integer"
},
"provided": true,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": true,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": true,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
]
}
}
Delete a source
Deletes an existing data source.
Resource List
Request Method |
DELETE |
Resource URL |
/v4/sources/{source_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source to be deleted. |
Returns
If successful, the API will return a status of 200 OK
and a Source object with a report_card
property. The deleted_at
attribute will be populated.
curl -X DELETE https://api.stitchdata.com/v4/sources/86741
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"properties":{
"anchor_time":"2019-01-30T18:16:37.205Z",
"cron_expression":null,
"frequency_in_minutes":"30",
"image_version":"1.latest",
"product":"pipeline",
"shop":"stitchdatawearhouse",
"start_date":"2017-01-01T00:00:00Z"
},
"updated_at":"2019-05-28T13:52:23Z",
"schedule":null,
"name":"shopify",
"type":"platform.shopify",
"deleted_at":"2019-05-28T13:52:23Z",
"system_paused_at":null,
"stitch_client_id":116078,
"paused_at":null,
"id":86741,
"display_name":"Shopify",
"created_at":"2019-01-10T19:38:18Z",
"report_card":{
"type":"platform.shopify",
"current_step":1,
"current_step_type":"fully_configured",
"steps":[
{
"type":"form",
"properties":[
{
"name":"anchor_time",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"format":"date-time"
},
"provided":true,
"tap_mutable":false
},
{
"name":"cron_expression",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":null,
"provided":false,
"tap_mutable":false
},
{
"name":"date_window_size",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"integer"
},
"provided":false,
"tap_mutable":false
},
{
"name":"frequency_in_minutes",
"is_required":false,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided":true,
"tap_mutable":false
},
{
"name":"image_version",
"is_required":true,
"is_credential":false,
"system_provided":true,
"property_type":"read_only",
"json_schema":null,
"provided":true,
"tap_mutable":false
},
{
"name":"shop",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string"
},
"provided":true,
"tap_mutable":false
},
{
"name":"start_date",
"is_required":true,
"is_credential":false,
"system_provided":false,
"property_type":"user_provided",
"json_schema":{
"type":"string",
"pattern":"^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided":true,
"tap_mutable":false
}
]
},
{
"type":"oauth",
"properties":[
{
"name":"api_key",
"is_required":true,
"is_credential":true,
"system_provided":true,
"property_type":"system_provided_by_default",
"json_schema":{
"type":"string"
},
"provided":false,
"tap_mutable":false
}
]
},
{
"type":"discover_schema",
"properties":[
]
},
{
"type":"field_selection",
"properties":[
]
},
{
"type":"fully_configured",
"properties":[
]
}
]
}
}
Code | Condition | Response Body |
400 |
Invalid source ID |
|
Connection Checks
OBJECT | Connection Check Object |
A Connection Check object shows the results from a test of a connection’s parameters. This is a test performed by Stitch that checks the configuration of a source’s connection parameters. The nature of the test varies by connection type. |
GET | Retrieve a source's last connection check |
Retrieves the last connection check for a source by the source’s unique identifier. |
The Connection Check Object
A Connection Check object shows the results from a test of a connection’s parameters. This is a test performed by Stitch that checks the configuration of a source’s connection parameters. The nature of the test varies by connection type.
name
STRING |
The name of the connection check job. |
mode
STRING |
This value will always be |
status
STRING |
The status of the connection check job. Possible values are:
|
start_time
TIMESTAMP |
The date and time the connection check job started. |
completion_time
TIMESTAMP |
The date and time the connection check job was completed. |
error
BOOLEAN |
Indicates if the connection check job resulted in an error. This will be |
check_exit_status
INTEGER |
The exit status of the connection check job. Possible values are:
|
discovery_exit_status
INTEGER |
The exit status of the discovery portion of the connection check job. Possible values are:
|
discovery_error_message
STRING |
Exception message raised when discovery failed during the connection check job. If successful, this will be |
tap_exit_status
INTEGER |
The exit status of the tap. Possible values are:
|
tap_error_message
STRING |
Exception message raised when extraction failed during the job. If successful, this will be |
target_exit_status
INTEGER |
The exit status of the target portion of the connection check job. Possible values are:
|
target_error_message
STRING |
This value will always be |
Retrieve a source's last connection check
Retrieves the last connection check for a source by the source’s unique identifier.
Resource List
Request Method |
GET |
Resource URL |
/v4/sources/{source_id}/last-connection-check |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source. |
Returns
If successful, the API will return a status of 200 OK
and a single Connection Check object.
curl -X GET https://api.stitchdata.com/v4/sources/86741/last-connection-check
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
In progress connection check:
{
"target_exit_status": null,
"tap_error_message": null,
"check_exit_status": null,
"name":"116078.120645.check.7bc049a4-18cf-11e9-a502-0e61abdd375a",
"start_time":"2018-10-08T18:12:34Z",
"mode":"check",
"tap_exit_status": null,
"target_error_message":null,
"discovery_exit_status": null,
“status”: “running”,
"completion_time": null,
"error":false,
"discovery_error_message":null
}
Successful connection check:
{
"target_exit_status": null,
"tap_error_message": null,
"check_exit_status": 0,
"name": "116078.122635.check.c5e705e2-1b62-11e9-b0e4-0e61abdd375a",
"start_time": "2019-01-18T20:51:05Z",
"mode": "check",
"tap_exit_status": null,
"target_error_message": null,
"discovery_exit_status": 0,
"status": "succeeded",
"completion_time": "2019-01-18T20:51:07Z",
"error": false,
"discovery_error_message": null
}
Failed connection check:
{
"target_exit_status": null,
"tap_error_message": null,
"check_exit_status": null,
"name":"116078.120645.check.7bc049a4-18cf-11e9-a502-0e61abdd375a",
"start_time":"2018-10-08T18:12:34Z",
"mode":"check",
"tap_exit_status": null,
"target_error_message":null,
"discovery_exit_status": null,
“status”: “running”,
"completion_time": null,
"error":false,
"discovery_error_message":null
}
Streams
OBJECT | Stream Object |
An object representing a table in a data source. |
GET | List streams for a source |
Lists the available streams for a source. |
GET | Retrieve a stream's schema |
Retrieves the schema for a source’s stream by the source and stream’s unique identifiers. |
PUT | Update a stream's metadata |
Updates the metadata for streams and fields. This endpoint is used to define the |
The Stream Object
An object representing a table in a data source.
stream_id
INTEGER |
The stream ID. |
selected
BOOLEAN |
Indicates if the stream is selected for replication. Possible values are:
|
stream_name
STRING |
The name of the stream. This value may not be unique. For example: A database with multiple schemas can have the same stream name in multiple schemas. |
tap_stream_id
STRING |
The unique version of the stream name. For database sources, this value will be the database name, schema name, and table name, combined. |
metadata
OBJECT (STREAM LEVEL METADATA) |
Details about the stream including its selection status, replication details, and key properties. |
List streams for a source
Lists the available streams for a source.
Resource List
Request Method |
GET |
Resource URL |
/v4/sources/{source_id}/streams |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source containing the streams. |
Returns
If successful, the API will return a status of 200 OK
and an array of Stream objects, one for each available stream in the source.
curl -X GET https://api.stitchdata.com/v4/sources/120643/streams
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
Database source:
[
{
"selected": null,
"stream_id": 2289176,
"tap_stream_id": "demni2mf59dt10-heroku-orders",
"stream_name": "orders",
"metadata": {
"database-name": "demni2mf59dt10",
"selected": null,
"is-view": false,
"row-count": 447,
"schema-name": "heroku",
"table-key-properties": [
"id"
]
}
},
{
"selected": null,
"stream_id": 2343457,
"tap_stream_id": "demni2mf59dt10-public-customers",
"stream_name": "customers",
"metadata": {
"database-name": "demni2mf59dt10",
"selected": null,
"is-view": false,
"row-count": 0,
"schema-name": "public",
"table-key-properties": [
"id"
]
}
},
{
"selected": true,
"stream_id": 2288740,
"tap_stream_id": "demni2mf59dt10-public-zapier_table",
"stream_name": "addresses",
"metadata": {
"database-name": "demni2mf59dt10",
"selected": true,
"is-view": false,
"replication-method": "FULL_TABLE",
"row-count": 0,
"schema-name": "public",
"table-key-properties": [
"id"
]
}
},
{
"selected": false,
"stream_id": 2375830,
"tap_stream_id": "demni2mf59dt10-public-customer_view",
"stream_name": "customer_view",
"metadata": {
"database-name": "demni2mf59dt10",
"selected": false,
"is-view": true,
"replication-key": "id",
"replication-method": "INCREMENTAL",
"row-count": 0,
"schema-name": "public",
"table-key-properties": [],
"view-key-properties": [
"id"
]
}
}
]
SaaS source:
[
{
"selected": true,
"stream_id": 2288757,
"tap_stream_id": "abandoned_checkouts",
"stream_name": "abandoned_checkouts",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": true,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": true,
"stream_id": 2288759,
"tap_stream_id": "collects",
"stream_name": "collects",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": true,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": null,
"stream_id": 2288758,
"tap_stream_id": "custom_collections",
"stream_name": "custom_collections",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": null,
"stream_id": 2288756,
"tap_stream_id": "customers",
"stream_name": "customers",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": null,
"stream_id": 2288754,
"tap_stream_id": "metafields",
"stream_name": "metafields",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": null,
"stream_id": 2288751,
"tap_stream_id": "order_refunds",
"stream_name": "order_refunds",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"created_at"
]
}
},
{
"selected": null,
"stream_id": 2288753,
"tap_stream_id": "orders",
"stream_name": "orders",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": null,
"stream_id": 2288755,
"tap_stream_id": "products",
"stream_name": "products",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"selected": null,
"stream_id": 2288752,
"tap_stream_id": "transactions",
"stream_name": "transactions",
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": null,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"created_at"
]
}
}
]
Retrieve a stream's schema
Retrieves the schema for a source’s stream by the source and stream’s unique identifiers.
Resource List
Request Method |
GET |
Resource URL |
/v4/sources/{source_id}/streams/{stream_id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source containing the stream. |
stream_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the stream to be retrieved. |
Returns
If successful and valid identifiers were provided, the API will return a status of 200 OK
and a single Stream Schema Object.
curl -X GET https://api.stitchdata.com/v4/sources/120643/streams/2339248
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"schema": "{\"properties\":{\"position\":{\"type\":[\"null\",\"integer\"]},\"created_at\":{\"type\":[\"null\",\"string\"],\"format\":\"date-time\"},\"sort_value\":{\"type\":[\"null\",\"string\"]},\"collection_id\":{\"type\":[\"null\",\"integer\"]},\"id\":{\"type\":[\"null\",\"integer\"]},\"product_id\":{\"type\":[\"null\",\"integer\"]},\"updated_at\":{\"type\":[\"null\",\"string\"],\"format\":\"date-time\"},\"featured\":{\"type\":[\"null\",\"boolean\"]}},\"type\":\"object\"}",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": true,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
},
{
"breadcrumb": [
"properties",
"collection_id"
],
"metadata": {
"inclusion": "available",
"selected": true
}
},
{
"breadcrumb": [
"properties",
"created_at"
],
"metadata": {
"inclusion": "available",
"selected": false
}
},
{
"breadcrumb": [
"properties",
"featured"
],
"metadata": {
"inclusion": "available",
"selected": false
}
},
{
"breadcrumb": [
"properties",
"id"
],
"metadata": {
"inclusion": "automatic",
"selected": false
}
},
{
"breadcrumb": [
"properties",
"position"
],
"metadata": {
"inclusion": "available",
"selected": false
}
},
{
"breadcrumb": [
"properties",
"product_id"
],
"metadata": {
"inclusion": "available",
"selected": false
}
},
{
"breadcrumb": [
"properties",
"sort_value"
],
"metadata": {
"inclusion": "available",
"selected": false
}
},
{
"breadcrumb": [
"properties",
"updated_at"
],
"metadata": {
"inclusion": "automatic",
"selected": false
}
}
],
"non-discoverable-metadata-keys": [
"selected",
"replication-method",
"replication-key",
"view-key-properties"
]
}
Code | Condition | Response Body |
400 |
Invalid stream ID |
“ |
400 |
Invalid source ID |
“ |
Update a stream's metadata
Updates the metadata for streams and fields. This endpoint is used to define the metadata
properties returned in the Stream Schema object’s non-discoverable-metadata-keys
property.
Refer to the Select streams and fields guide for instructions on selecting streams and fields.
Resource List
Request Method |
PUT |
Resource URL |
/v4/sources/{source_id}/streams/metadata |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source containing the stream(s). |
||||||||
streams
ARRAY REQUIRED |
An array of Stream objects, with each object corresponding to a stream to be updated. Each object is required to have the following properties:
|
Returns
If successful, the API will return a status of 200 OK
and a JSON body of:
{
"status": 200
}
Selecting a single stream:
curl -X PUT https://api.stitchdata.com/v4/sources/120645/streams/metadata
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"streams": [
{
"tap_stream_id": "custom_collections",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"selected": "true"
}
}
]
}
]
}"
Selecting a single stream and multiple fields:
curl -X PUT https://api.stitchdata.com/v4/sources/120645/streams/metadata
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"streams": [
{
"tap_stream_id": "custom_collections",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"title"
],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"published_at"
],
"metadata": {
"selected": true
}
}
]
}
]
}"
Selecting multiple streams and fields:
curl -X PUT https://api.stitchdata.com/v4/sources/120645/streams/metadata
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"streams": [
{
"tap_stream_id": "custom_collections",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"title"
],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"published_at"
],
"metadata": {
"selected": true
}
}
]
},
{
"tap_stream_id": "customers",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"first_name"
],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"last_name"
],
"metadata": {
"selected": true
}
}
]
}
]
}'
Selecting a database table and defining replication:
curl -X PUT https://api.stitchdata.com/v4/sources/120645/streams/metadata
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"streams": [
{
"tap_stream_id": "demni2mf59dt10-public-customers",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"selected": true,
"replication-method": "INCREMENTAL",
"replication-key": "updated_at"
}
},
{
"breadcrumb": [
"properties",
"name"
],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"has_magic"
],
"metadata": {
"selected": true
}
}
]
}
]
}"
Selecting a database view and defining replication:
curl -X PUT https://api.stitchdata.com/v4/sources/120645/streams/metadata
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"streams": [
{
"tap_stream_id": "demni2mf59dt10-public-customer_view",
"metadata": [
{
"breadcrumb": [],
"metadata": {
"replication-key": "updated_at",
"view-key-properties": [
"id"
],
"replication-method": "INCREMENTAL",
"selected": true
}
},
{
"breadcrumb": [
"properties",
"name"
],
"metadata": {
"selected": true
}
},
{
"breadcrumb": [
"properties",
"has_magic"
],
"metadata": {
"selected": true
}
}
]
}
]
}"
Applicable to all requests:
{
"status": 200
}
Code | Condition | Response Body |
400 |
Missing |
|
400 |
Invalid |
|
400 |
Request body includes read-only properties |
|
400 |
Request body includes unsupported fields |
|
400 |
Request body is missing |
|
Replication Jobs
OBJECT | Replication Job Object |
The three-step process by which Stitch replicates data. A replication job includes three distinct steps: Extraction, preparation, and loading. |
POST | Start a replication job | |
DELETE | Stop a replication job |
The Replication Job Object
The three-step process by which Stitch replicates data. A replication job includes three distinct steps: Extraction, preparation, and loading.
job_name
STRING |
A unique identifier for the replication job. |
Start a replication job
Manually starts a replication job for a source using the source’s unique identifier. Manual replication jobs can be started for active and paused sources.
Note: Stitch allows only one replication job to run at a time. Attempting to start a job when another is in progress will return a status of 200 OK
and a single error object. See the Responses tab below for an example.
Resource List
Request Method |
POST |
Resource URL |
/v4/sources/{source_id}/sync |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source. |
Returns
If successful, the API will return a status of 200 OK
and single Replication Job object.
Note: Stitch allows only one replication job to run at a time. Attempting to start a job when another is in progress will return a status of 200 OK
and a single error object.
curl -X POST https://api.stitchdata.com/v4/sources/120643/sync
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
Replication job successfully started:
{
"job_name": "116078.120643.sync.c12fb0a7-7e4a-11e9-abdc-0edc2c318fba"
}
Replication not started; another job is in progress:
{
"error": {
"type": "already_running",
"message": "Did not create job for client-id: <CLIENT_ID>; connection-id: <SOURCE_ID> because one already exists"
}
}
Code | Condition | Response Body |
200 |
Replication job is already in progress |
|
400 |
Invalid source ID |
|
400 |
Source has been deleted |
|
Stop a replication job
Manually stops an in-progress replication job for a source using the source’s unique identifier.
Resource List
Request Method |
DELETE |
Resource URL |
/v4/sources/{source_id}/sync |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
source_id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the source. |
Returns
If successful, the API will return a status of 200 OK
and an object with a status
property with a value of 200
.
curl -X DELETE https://api.stitchdata.com/v4/sources/120643/sync
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"status": 200
}
Notifications
OBJECT | Notification Object |
An object representing a notification configuration in Stitch. This applies to the Custom email notification list and Post-load hook features. |
POST | Create a custom email |
Creates a custom email notification recipient. |
PUT | Disable a custom email |
Disables (pauses) an existing custom email notification recipient. |
PUT | Re-enable a custom email |
Re-enables (unpauses) an existing custom email notification recipient. |
GET | List custom emails |
Retrieves a list of all custom email notification recipients for a Stitch account. |
DELETE | Delete a custom email |
Deletes an existing custom email notification recipient. |
POST | Create a webhook |
Creates a hook notification. |
PUT | Disable a webhook |
Disables an existing hook notification. |
PUT | Re-enable a webhook |
Re-enables a disabled hook notification. |
GET | List webhooks |
Retrieves a list of all hook notifications for a Stitch account. |
DELETE | Delete a webhook |
Deletes an existing hook notification. |
The Notification Object
An object representing a notification configuration in Stitch. This applies to the Custom email notification list and Post-load hook features.
id
INTEGER |
The notification ID. |
||
client_id
INTEGER |
The ID of the Stitch client account. |
||
created_at
DATE-TIME |
The time at which the notification was created. |
||
modified_at
DATE-TIME |
The time at which the notification was last modified. |
||
disabled_at
DATE-TIME |
The time at which the notification was disabled. This will be |
||
email_address
STRING |
Applicable to custom email notifications only. The email address of the custom notification recipient. |
||
version
INTEGER |
Applicable to custom email notifications only. The version of the hook service the notification is using. |
||
type
STRING |
Applicable to hook notifications only. The type of the notification. |
||
config
OBJECT |
Applicable to hook notifications only. The configuration for the hook.
|
Create a custom email
Creates a custom email notification recipient.
Note: To use this endpoint, your Stitch plan must include access to the Custom notification list feature.
Resource List
Request Method |
POST |
Resource URL |
/notifications/public/v1/api/custom-emails |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
email_address
STRING REQUIRED |
The email address that custom email notifications should be sent to. |
Returns
If successful, the API will return a status of 200 OK
and a single Custom Email Notification object.
curl -X POST https://api.stitchdata.com/notifications/public/v1/api/custom-emails
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"email_address": "stitch-custom-notification@yourdomain.com"
}"
{
"id": 22,
"client_id": 116078,
"email_address": "stitch-custom-notification@yourdomain.com",
"created_at": "2019-07-16T19:49:51Z",
"disabled_at": null
}
Code | Condition | Response Body |
400 |
|
|
400 |
Account has reached the maximum number of allowed custom emails. The current limit is 10. |
|
400 |
Account doesn’t have access to the Custom notification list feature |
|
Disable a custom email
Disables (pauses) an existing custom email notification recipient.
Note: To use this endpoint, your Stitch plan must include access to the Custom notification list feature.
Resource List
Request Method |
PUT |
Resource URL |
/notifications/public/v1/api/custom-emails/{id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the custom notification recipient to be paused. |
disabled_at
TIMESTAMP REQUIRED |
The time the custom notification was paused. This field must contain an ISO 8601-compliant date. Note: Providing any value - past, present, or future - for this property will pause the custom notification recipient immediately if the request is successful. |
Returns
If successful, the API will return a status of 200 OK
and single object with a disabled_at
property.
curl -X PUT https://api.stitchdata.com/notifications/public/v1/api/custom-emails/22
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"disabled_at": "2019-06-01T00:00:00Z"
}"
{
"disabled_at": "2019-06-01T00:00:00Z"
}
Code | Condition | Response Body |
400 |
|
|
404 |
Notification ID is missing or invalid |
|
Re-enable a custom email
Re-enables (unpauses) an existing custom email notification recipient.
Note: To use this endpoint, your Stitch plan must include access to the Custom notification list feature.
Resource List
Request Method |
PUT |
Resource URL |
/notifications/public/v1/api/custom-emails/{id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the custom notification recipient to be re-enabled. |
disabled_at
NULL REQUIRED |
To re-enable a custom notification recipient, this value must be |
Returns
If successful, the API will return a status of 200 OK
and single object with a disabled_at
property with a null
value.
curl -X PUT https://api.stitchdata.com/notifications/public/v1/api/custom-emails/22
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"disabled_at": null
}"
{
"disabled_at": null
}
Code | Condition | Response Body |
400 |
|
|
404 |
Notification ID is missing or invalid |
|
List custom emails
Retrieves a list of all custom email notification recipients for a Stitch account. This includes custom notification recipients that have been disabled.
Note: To use this endpoint, your Stitch plan must include access to the Custom notification list feature.
Resource List
Request Method |
GET |
Resource URL |
/notifications/public/v1/api/custom-emails |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and an array of Custom Email Notification objects, one for each custom notification recipient.
curl -X GET https://api.stitchdata.com/notifications/public/v1/api/custom-emails
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
[
{
"id": 22,
"client_id": 116078,
"email_address": "stitch-custom-notification@stitchdata.com",
"created_at": "2019-07-16T19:49:51Z",
"disabled_at": null
},
{
"id": 23,
"client_id": 116078,
"email_address": "another-custom-notification@stitchdata.com",
"created_at": "2019-07-16T20:43:51Z",
"disabled_at": null
}
]
Delete a custom email
Deletes an existing custom email notification recipient.
Note: To use this endpoint, your Stitch plan must include access to the Custom notification list feature.
Resource List
Request Method |
DELETE |
Resource URL |
/notifications/public/v1/api/custom-emails/{id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the custom notification recipient to be deleted. |
Returns
If successful, the API will return a status of 200 OK
and an array containing 1
, indicating that one custom notification recipient was successfully deleted.
curl -X DELETE https://api.stitchdata.com/notifications/public/v1/api/custom-emails/22
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
[
1
]
Create a webhook
Creates a hook notification.
Note: To use this endpoint, your Stitch plan must include access to the Post-load hooks feature.
Resource List
Request Method |
POST |
Resource URL |
/notifications/public/v1/api/hooks |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
type
STRING REQUIRED |
The type of hook notification to be created. This must be |
config
OBJECT REQUIRED |
The configuration details of the hook. |
Returns
If successful, the API will return a status of 200 OK
and a single Hook notification object.
curl -X POST https://api.stitchdata.com/notifications/public/v1/api/hooks
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"type":"post_load",
"config":{
"url":"https://hooks.zapier.com/hooks/catch/some/webhook/id"
}
}"
{
"id": 8,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some/webhook/id"
},
"created_at": "2019-07-17T17:30:37Z",
"modified_at": "2019-07-17T17:30:37Z",
"disabled_at": null
}
Code | Condition | Response Body |
400 |
Missing or prohibited arguments |
|
400 |
Account doesn’t have access to the Hook notification feature |
|
400 |
Account has reached the maximum number of allowed hook notifications. The current limit is 10. |
|
Disable a webhook
Disables an existing hook notification.
Note: To use this endpoint, your Stitch plan must include access to the Post-load hooks feature.
Resource List
Request Method |
PUT |
Resource URL |
/notifications/public/v1/api/hooks/{id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the hook notification to be paused. |
enable
BOOLEAN REQUIRED |
Controls whether a hook notification is active or not. To disable a hook, this value must be |
Returns
If successful, the API will return a status of 200 OK
and a single Hook notification object with a populated disabled_at
property.
curl -X PUT https://api.stitchdata.com/notifications/public/v1/api/hooks/8
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"enable":false
}"
{
"id": 8,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some/webhook/id"
},
"created_at": "2019-07-16T16:47:54Z",
"modified_at": "2019-07-17T16:04:29Z",
"disabled_at": "2019-07-17T16:04:29Z"
}
Code | Condition | Response Body |
400 |
Missing or incorrectly typed |
|
Re-enable a webhook
Re-enables a disabled hook notification.
Note: To use this endpoint, your Stitch plan must include access to the Post-load hooks feature.
Resource List
Request Method |
PUT |
Resource URL |
/notifications/public/v1/api/hooks/{id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the hook notification to be re-enabled. |
enable
BOOLEAN REQUIRED |
Controls whether a hook notification is active or not. To re-enable a hook, this value must be |
Returns
If successful, the API will return a status of 200 OK
and a single Hook notification object with a null disabled_at
property.
curl -X PUT https://api.stitchdata.com/notifications/public/v1/api/hooks/8
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d "{
"enable":true
}"
{
"id": 8,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some/webhook/id"
},
"created_at": "2019-07-16T16:47:54Z",
"modified_at": "2019-07-17T16:04:29Z",
"disabled_at": null
}
Code | Condition | Response Body |
400 |
Missing or incorrectly typed |
|
List webhooks
Retrieves a list of all hook notifications for a Stitch account. This includes hooks that have been disabled.
Note: To use this endpoint, your Stitch plan must include access to the Post-load hooks feature.
Resource List
Request Method |
GET |
Resource URL |
/notifications/public/v1/api/hooks |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Returns
If successful, the API will return a status of 200 OK
and a post_load
property containing an array of Hook Notification objects, one for each hook notification in the Stitch account.
curl -X GET https://api.stitchdata.com/notifications/public/v1/api/hooks
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
{
"post_load": [
{
"id": 8,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some/webhook/id"
},
"created_at": "2019-07-16T16:47:54Z",
"modified_at": "2019-07-16T16:47:54Z",
"disabled_at": null
},
{
"id": 9,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some/webhook/id"
},
"created_at": "2019-07-16T16:51:20Z",
"modified_at": "2019-07-16T16:51:20Z",
"disabled_at": null
},
{
"id": 10,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some/webhook/id"
},
"created_at": "2019-07-17T15:54:25Z",
"modified_at": "2019-07-18T15:36:53Z",
"disabled_at": "2019-07-18T15:36:53Z"
}
]
}
Delete a webhook
Deletes an existing hook notification.
Note: To use this endpoint, your Stitch plan must include access to the Post-load hooks feature.
Resource List
Request Method |
DELETE |
Resource URL |
/notifications/public/v1/api/hooks/{id} |
Authorization |
Required. The request header must contain Authorization and your access token. |
Request Header |
The request header must contain the following:
See the Request tab below for an example request. |
Request Body |
The request body must be valid JSON and contain the required arguments. |
Response Format |
Whether the request succeeds or fails, the API will return JSON. |
Arguments
This endpoint accepts the following parameters:
id
PATH PARAMETER REQUIRED |
A path parameter corresponding to the unique ID of the hook notification to be deleted. |
Returns
If successful, the API will return a status of 200 OK
and a null
body.
curl -X DELETE https://api.stitchdata.com/notifications/public/v1/api/hooks/8
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
null
Code | Condition | Response Body |
400 |
Invalid hook notification ID |
|
Data Structures
OBJECT | Connection Step |
Contained in a Source or Destination Report Card object, the Connection Steps object contains the steps necessary to configure a data source or destination. |
OBJECT | Details |
Contained in a Source or Destination Report Card object, the Details object contains information about a connection Note: This object will only be returned when using a |
OBJECT | Metadata |
A Metadata object describes a stream’s schema and the current state of its configuration in Stitch, including its selection status, field inclusion list, Primary Keys, and Replication Method. Refer to the Select streams and fields guide for instructions on selecting streams and fields. |
OBJECT | Custom Email Notification |
A Custom Email Notification object contains information about an email address configured in the account’s Custom Notification list. |
OBJECT | Hook Notification |
A Hook Notification object contains information about a webhook configured in the account’s Post-load hook list. |
OBJECT | Properties |
A Properties object contains the properties necessary to complete a connection step. Returned within a Source or Destination object, these properties provide information about the configuration status of the connection. |
OBJECT | Destination Report Card |
A Destination Report Card object contains information about a destination’s connection configuration. |
OBJECT | Source Report Card |
A Source Report Card object contains information about a source’s connection configuration. |
OBJECT | Stream Schema |
A Stream Schema object contains information needed to select a stream and its fields for replication. |
The Connection Step Object
Contained in a Source or Destination Report Card object, the Connection Steps object contains the steps necessary to configure a data source or destination.
type
STRING |
The type of step. Possible values are:
|
properties
ARRAY |
An array of Properties objects. |
Example Object
{
"report_card":{
"type":"platform.hubspot",
"current_step":2,
"steps":[
{
"type":"form",
"properties":[]
},
{
"type":"oauth",
"properties":[]
},
{
"type":"discover_schema",
"properties":[]
},
{
"type":"field_selection",
"properties":[]
},
{
"type":"fully_configured",
"properties":[]
}
]
}
}
The Details Object
Contained in a Source or Destination Report Card object, the Details object contains information about a connection type
’s availability within Stitch.
Note: This object will only be returned when using a GET
method.
access
BOOLEAN |
Indicates whether the Stitch client who made the request has access to the connection. This value is based on the connection’s All connections with a |
default_scheduling_interval
INTEGER |
Applicable only to source report cards. The default |
pricing_tier
STRING |
Indicates the type of Stitch plan required to use the connection. Possible values are:
|
default_start_date
STRING |
Applicable only to source report cards. The default |
pipeline_state
STRING |
The connection
|
protocol
STRING |
The |
Example Object
{
"details":{
"pricing_tier":"standard",
"pipeline_state":"released",
"protocol":"snowflake",
"access":true
}
}
{
"details":{
"pricing_tier":"enterprise",
"pipeline_state":"released",
"default_scheduling_interval":60,
"default_start_date": null,
"protocol":"platform.oracle",
"access":false
}
}
The Metadata Object
A Metadata object describes a stream’s schema and the current state of its configuration in Stitch, including its selection status, field inclusion list, Primary Keys, and Replication Method.
Refer to the Select streams and fields guide for instructions on selecting streams and fields.
breadcrumbs
ARRAY |
An array of strings describing a path into the schema. For example:
|
metadata
OBJECT |
An object containing metadata associated with the
|
Example Object
{
"metadata":[
{
"breadcrumb":[],
"metadata":{
"database-name":"demni2mf59dt10",
"is-view":false,
"row-count":90849,
"schema-name":"products",
"table-key-properties":[
"id"
]
}
},
{
"breadcrumb":[
"properties",
"collection_id"
],
"metadata":{
"inclusion":"available",
"selected-by-default":true,
"sql-datatype":"bigint"
}
},
{
"breadcrumb":[
"properties",
"id"
],
"metadata":{
"inclusion":"automatic",
"selected-by-default":true,
"sql-datatype":"bigint"
}
},
{
"breadcrumb":[
"properties",
"updated_at"
],
"metadata":{
"inclusion":"available",
"selected-by-default":true,
"sql-datatype":"timestamp with time zone"
}
}
]
}
{
"metadata":[
{
"breadcrumb":[],
"metadata":{
"forced-replication-method":"INCREMENTAL",
"selected":true,
"table-key-properties":[
"id"
],
"valid-replication-keys":[
"updated_at"
]
}
},
{
"breadcrumb":[
"properties",
"collection_id"
],
"metadata":{
"inclusion":"available",
"selected":true
}
},
{
"breadcrumb":[
"properties",
"created_at"
],
"metadata":{
"inclusion":"available",
"selected":false
}
},
{
"breadcrumb":[
"properties",
"featured"
],
"metadata":{
"inclusion":"available",
"selected":false
}
},
{
"breadcrumb":[
"properties",
"id"
],
"metadata":{
"inclusion":"automatic",
"selected":false
}
},
{
"breadcrumb":[
"properties",
"position"
],
"metadata":{
"inclusion":"available",
"selected":false
}
},
{
"breadcrumb":[
"properties",
"product_id"
],
"metadata":{
"inclusion":"available",
"selected":false
}
},
{
"breadcrumb":[
"properties",
"sort_value"
],
"metadata":{
"inclusion":"available",
"selected":false
}
},
{
"breadcrumb":[
"properties",
"updated_at"
],
"metadata":{
"inclusion":"automatic",
"selected":false
}
}
]
}
The Field-level Metadata Object
Contained in a Metadata object, the Field-level metadata object contains information about a field’s inclusion in a stream’s field selection list.
Refer to the Field selection and compatibility rules guide for info about selection and compatibility rules.
inclusion
STRING |
Indicates when a field will be included. Possible values are:
If a field is |
selected
BOOLEAN |
Indicates whether a field should be included in a stream’s field selection list. This value will be present only if the stream containing the field is selected (
|
selected-by-default
BOOLEAN |
Indicates if a field will be selected by default. Possible values are:
|
sql-datatype
STRING |
For database sources only. The data type of a column from a database. |
fieldExclusions
ARRAY |
A list of arrays, each array containing an array of strings that correspond to fields that are incompatible when the current field is selected. For example: If the metadata for a Refer to the example tabs below for an example of this property. |
unsupported-description
STRING |
The reason a field is unsupported ( |
Example Object
{
"metadata": {
"sql-datatype": "double precision",
"selected-by-default": true,
"inclusion": "available"
}
{
"metadata": {
"selected": false,
"inclusion": "available"
}
{
"breadcrumb": [
"properties",
"DeviceOS"
],
"metadata": {
"fieldExclusions": [
[
"properties",
"ExactMatchImpressionSharePercent"
],
[
"properties",
"ImpressionLostToAdRelevancePercent"
],
[
"properties",
"ImpressionLostToBidPercent"
],
[
"properties",
"ImpressionLostToBudgetPercent"
],
[
"properties",
"ImpressionLostToExpectedCtrPercent"
],
[
"properties",
"ImpressionLostToRankPercent"
],
[
"properties",
"ImpressionSharePercent"
]
],
"inclusion": "available"
}
}
{
"metadata": {
"unsupported-description": "this field is unsupported by the Bulk API.",
"selected": false,
"inclusion": "unsupported"
}
The Stream-level Metadata Object
Contained in Metadata and Stream objects, the Stream-level Metadata object contains information about a stream’s configuration in Stitch. This includes information about its selection status, Replication Method, Replication Keys, and key properties.
database-name
STRING |
For database sources only. The name of the database containing the stream. |
forced-replication-method
STRING |
Indicates which Replication Method is required for the stream. Possible values are:
|
is-view
BOOLEAN |
For database sources only. Indicates if the stream is a database view. |
replication-key
STRING |
Indicates the field being used as the stream’s Replication Key. |
replication-method
STRING |
The Replication Method the stream uses to replicate data. Accepted values are:
|
row-count
INTEGER |
For database sources only. The number of rows (records) in the stream. |
schema-name
STRING |
For database sources only. The name of the schema containing the stream. |
selected
BOOLEAN |
Indicates whether a stream should be set to replicate. Accepted values are:
|
table-key-properties
ARRAY |
An array of strings listing the fields that make up the key properties of the table. These are the table’s defined Primary Keys. |
valid-replication-keys
ARRAY |
An array of strings indicating the fields valid for use as Replication Keys in Key-based Incremental Replication ( Note: For SaaS sources, the fields listed in this array are pre-defined by Stitch and will be used as the Replication Keys for the stream. They cannot be modified. |
view-key-properties
ARRAY |
For database sources only. An array of strings listing the fields that make up the key properties of the view. |
Example Object
{
"metadata": {
"database-name": "demni2mf59dt10",
"selected": true,
"is-view": false,
"replication-method": "FULL_TABLE",
"row-count": 13,
"schema-name": "public",
"table-key-properties": [
"id"
]
}
}
{
"metadata": {
"database-name": "demni2mf59dt10",
"selected": true,
"replication-method":"INCREMENTAL",
"replication-key":"updated_at",
"is-view": true,
"row-count": 156,
"schema-name": "heroku",
"view-key-properties": [
"customer_id"
]
}
}
{
"metadata": {
"forced-replication-method": "INCREMENTAL",
"selected": true,
"table-key-properties": [
"id"
],
"valid-replication-keys": [
"updated_at"
]
}
}
The Custom Email Notification Object
A Custom Email Notification object contains information about an email address configured in the account’s Custom Notification list.
id
INTEGER |
The notification ID. |
client_id
INTEGER |
The ID of the Stitch client account. |
created_at
DATE-TIME |
The time at which the notification was created. |
modified_at
DATE-TIME |
The time at which the notification was last modified. |
disabled_at
DATE-TIME |
The time at which the notification was disabled. This will be |
email_address
STRING |
The email address of the custom notification recipient. |
Example Object
{
"id": 21,
"client_id": 116078,
"email_address": "stitch-custom-notification@yourdomain.com",
"created_at": "2019-07-16T17:35:25Z",
"disabled_at": null
}
The Hook Notification Object
A Hook Notification object contains information about a webhook configured in the account’s Post-load hook list.
id
INTEGER |
The notification ID. |
client_id
INTEGER |
The ID of the Stitch client account. |
created_at
DATE-TIME |
The time at which the notification was created. |
modified_at
DATE-TIME |
The time at which the notification was last modified. |
disabled_at
DATE-TIME |
The time at which the notification was disabled. This will be |
type
STRING |
The type of the notification. Possible values are:
|
version
INTEGER |
The version of the hook service the notification is using. |
config
OBJECT |
The configuration for the hook. |
Example Object
{
"id": 9,
"client_id": 116078,
"type": "post_load",
"version": 1,
"config": {
"url": "https://hooks.zapier.com/hooks/catch/some-hook-id"
},
"created_at": "2019-07-16T16:51:20Z",
"modified_at": "2019-07-16T16:51:20Z",
"disabled_at": null
}
The Properties Object
A Properties object contains the properties necessary to complete a connection step. Returned within a Source or Destination object, these properties provide information about the configuration status of the connection.
name
STRING |
The name of the property. |
is_required
BOOLEAN |
If |
is_credential
BOOLEAN |
If |
system_provided
BOOLEAN |
This property has been deprecated. Use the |
property_type
STRING |
Indicates the type of the property. Possible values are:
|
json_schema
ARRAY |
Note: Data will only be returned for this array if An array containing:
|
provided
BOOLEAN |
If |
tap_mutable
BOOLEAN |
This is an internal field and is for Stitch use only. |
Example Object
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
}
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
}
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
The Destination Report Card Object
A Destination Report Card object contains information about a destination’s connection configuration.
current_step
INTEGER |
The index (in the |
details
OBJECT (DETAILS) |
A Details object contains information about a connection |
steps
ARRAY |
A sequential list of Connection Step objects required to complete configuration for the connection type. |
type
STRING |
The destination connection type. For example: |
Example Object
{
"type": "redshift",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "database",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "encryption_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "encryption_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "encryption_type",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(ssh|none)$"
},
"provided": false
},
{
"name": "encryption_username",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"anyOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
},
{
"type": "string",
"format": "hostname"
}
]
},
"provided": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false
},
{
"name": "username",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false
}
]
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"protocol": "redshift",
"access": true
}
}
The Source Report Card Object
A Source Report Card object contains information about a source’s connection configuration.
current_step
INTEGER |
The index (in the |
details
OBJECT (DETAILS) |
A Details object contains information about a connection |
steps
ARRAY |
A sequential list of Connection Step objects required to complete configuration for the connection type. |
type
STRING |
The connection type. Ex: |
Example Object
{
"type": "platform.mysql",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "allow_non_auto_increment_pks",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "check_hostname",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "database",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "filter_dbs",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "host",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "password",
"is_required": true,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "port",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "server_id",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_host",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"anyOf": [
{
"format": "hostname"
},
{
"format": "ipv4"
}
]
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_port",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d+"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssh_user",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_ca",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_cert",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_client_auth_enabled",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
},
{
"name": "ssl_key",
"is_required": false,
"is_credential": true,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "user",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "use_log_based_replication",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "verify_mode",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^(true|false)"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "standard",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": null,
"protocol": "platform.mysql",
"access": true
}
}
{
"type": "platform.hubspot",
"current_step": 1,
"current_step_type": "form",
"steps": [
{
"type": "form",
"properties": [
{
"name": "anchor_time",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"format": "date-time"
},
"provided": false,
"tap_mutable": false
},
{
"name": "cron_expression",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "frequency_in_minutes",
"is_required": false,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^1$|^30$|^60$|^360$|^720$|^1440$"
},
"provided": false,
"tap_mutable": false
},
{
"name": "image_version",
"is_required": true,
"is_credential": false,
"system_provided": true,
"property_type": "read_only",
"json_schema": null,
"provided": false,
"tap_mutable": false
},
{
"name": "start_date",
"is_required": true,
"is_credential": false,
"system_provided": false,
"property_type": "user_provided",
"json_schema": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T00:00:00Z$"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "oauth",
"properties": [
{
"name": "client_id",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "client_secret",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
},
{
"name": "redirect_uri",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string",
"format": "uri"
},
"provided": false,
"tap_mutable": false
},
{
"name": "refresh_token",
"is_required": true,
"is_credential": true,
"system_provided": true,
"property_type": "system_provided_by_default",
"json_schema": {
"type": "string"
},
"provided": false,
"tap_mutable": false
}
]
},
{
"type": "discover_schema",
"properties": []
},
{
"type": "field_selection",
"properties": []
},
{
"type": "fully_configured",
"properties": []
}
],
"details": {
"pricing_tier": "premium",
"pipeline_state": "released",
"default_scheduling_interval": 30,
"default_start_date": "-30 days",
"protocol": "platform.hubspot",
"access": true
}
}
The Stream Schema Object
A Stream Schema object contains information needed to select a stream and its fields for replication.
schema
STRING |
The JSON schema describing the stream’s fields. |
metadata
ARRAY |
An array of Metadata objects. |
non-discoverable-metadata-keys
ARRAY |
An array of strings corresponding to |
Example Object
{
"schema": "{\"definitions\":{\"sdc_recursive_boolean_array\":{\"items\":{\"$ref\":\"#/definitions/sdc_recursive_boolean_array\"},\"type\":[\"null\",\"boolean\",\"array\"]},\"sdc_recursive_integer_array\":{\"items\":{\"$ref\":\"#/definitions/sdc_recursive_integer_array\"},\"type\":[\"null\",\"integer\",\"array\"]},\"sdc_recursive_number_array\":{\"items\":{\"$ref\":\"#/definitions/sdc_recursive_number_array\"},\"type\":[\"null\",\"number\",\"array\"]},\"sdc_recursive_timestamp_array\":{\"format\":\"date-time\",\"items\":{\"$ref\":\"#/definitions/sdc_recursive_timestamp_array\"},\"type\":[\"null\",\"string\",\"array\"]},\"sdc_recursive_object_array\":{\"items\":{\"$ref\":\"#/definitions/sdc_recursive_object_array\"},\"type\":[\"null\",\"object\",\"array\"]},\"sdc_recursive_string_array\":{\"items\":{\"$ref\":\"#/definitions/sdc_recursive_string_array\"},\"type\":[\"null\",\"string\",\"array\"]}},\"type\":\"object\",\"properties\":{\"age\":{\"maximum\":2147483647,\"type\":[\"null\",\"integer\"],\"minimum\":-2147483648},\"has_magic\":{\"type\":[\"null\",\"boolean\"]},\"name\":{\"type\":[\"null\",\"string\"]},\"id\":{\"maximum\":2147483647,\"type\":[\"integer\"],\"minimum\":-2147483648}}}",
"metadata": [
{
"breadcrumb": [
"properties",
"age"
],
"metadata": {
"sql-datatype": "integer",
"selected-by-default": true,
"inclusion": "available"
}
},
{
"breadcrumb": [],
"metadata": {
"database-name": "demni2mf59dt10",
"schema-name": "public",
"table-key-properties": [
"id"
],
"row-count": 0,
"is-view": false
}
},
{
"breadcrumb": [
"properties",
"id"
],
"metadata": {
"sql-datatype": "integer",
"selected-by-default": true,
"inclusion": "automatic"
}
},
{
"breadcrumb": [
"properties",
"name"
],
"metadata": {
"sql-datatype": "text",
"selected-by-default": true,
"inclusion": "available"
}
},
{
"breadcrumb": [
"properties",
"has_magic"
],
"metadata": {
"sql-datatype": "boolean",
"selected-by-default": true,
"inclusion": "available"
}
}
],
"non-discoverable-metadata-keys": [
"selected",
"replication-method",
"replication-key",
"view-key-properties"
]
}
{
"schema": "{\"type\":\"object\",\"properties\":{\"id\":{\"type\":[\"null\",\"integer\"]},\"sort_value\":{\"type\":[\"null\",\"string\"]},\"product_id\":{\"type\":[\"null\",\"integer\"]},\"updated_at\":{\"type\":[\"null\",\"string\"],\"format\":\"date-time\"},\"featured\":{\"type\":[\"null\",\"boolean\"]},\"position\":{\"type\":[\"null\",\"integer\"]},\"created_at\":{\"type\":[\"null\",\"string\"],\"format\":\"date-time\"},\"collection_id\":{\"type\":[\"null\",\"integer\"]}}}",
"metadata": [
{
"breadcrumb": [
"properties",
"sort_value"
],
"metadata": {
"selected": false,
"inclusion": "available"
}
},
{
"breadcrumb": [],
"metadata": {
"selected": true,
"valid-replication-keys": [
"updated_at"
],
"table-key-properties": [
"id"
],
"forced-replication-method": "INCREMENTAL"
}
},
{
"breadcrumb": [
"properties",
"position"
],
"metadata": {
"selected": false,
"inclusion": "available"
}
},
{
"breadcrumb": [
"properties",
"id"
],
"metadata": {
"selected": false,
"inclusion": "automatic"
}
},
{
"breadcrumb": [
"properties",
"collection_id"
],
"metadata": {
"selected": true,
"inclusion": "available"
}
},
{
"breadcrumb": [
"properties",
"featured"
],
"metadata": {
"selected": false,
"inclusion": "available"
}
},
{
"breadcrumb": [
"properties",
"product_id"
],
"metadata": {
"selected": false,
"inclusion": "available"
}
},
{
"breadcrumb": [
"properties",
"created_at"
],
"metadata": {
"selected": false,
"inclusion": "available"
}
},
{
"breadcrumb": [
"properties",
"updated_at"
],
"metadata": {
"selected": false,
"inclusion": "automatic"
}
}
],
"non-discoverable-metadata-keys": [
"selected",
"replication-method",
"replication-key",
"view-key-properties"
]
}
Form Properties
Stitch connects to a large, diverse universe of applications and data warehouses, each of which is configured differently.
The properties
objects contain the properties necessary to create a source or destination object.
For sources, these properties can also be found in the source’s report card step: form
.
OBJECT | Amazon Aurora Source Form Property |
An Amazon Aurora connection reads data from an Amazon Aurora database and corresponds to source |
OBJECT | Amazon S3 CSV Source Form Property |
An Amazon S3 CSV connection reads data from an Amazon S3 CSV database and corresponds to source |
OBJECT | Amazon S3 Destination Form Property |
A Amazon S3 connection writes data to a Amazon S3 database and corresponds to destination |
OBJECT | Amplitude Source Form Property |
Amplitude connections read data from the Amplitude API and correspond to source |
OBJECT | Asana Source Form Property |
Asana connections read data from the Asana API and correspond to source |
OBJECT | BigCommerce Source Form Property |
BigCommerce connections read data from the BigCommerce API and correspond to source |
OBJECT | Bing Ads Source Form Property |
Bing Ads connections read data from the Bing Ads API and correspond to source |
OBJECT | Bronto Source Form Property |
Bronto connections read data from the Bronto API and correspond to source |
OBJECT | Campaign Manager Source Form Property |
Campaign Manager connections read data from the Campaign Manager API and correspond to source |
OBJECT | Campaign Monitor Source Form Property |
Campaign Monitor connections read data from the Campaign Monitor API and correspond to source |
OBJECT | Chargebee Source Form Property |
Chargebee connections read data from the Chargebee API and correspond to source |
OBJECT | Close.io Source Form Property |
Close.io connections read data from the Close.io API and correspond to source |
OBJECT | Club Speed Source Form Property |
Club Speed connections read data from the Club Speed API and correspond to source |
OBJECT | Eloqua Source Form Property |
Eloqua connections read data from the Bulk and REST APIs
and correspond to source |
OBJECT | Facebook Ads Source Form Property |
Facebook Ads connections read data from the Facebook Ads API and correspond to source |
OBJECT | Front Source Form Property |
Front connections read data from the Front API and correspond to source |
OBJECT | FullStory Source Form Property |
FullStory connections read data from the FullStory API and correspond to source |
OBJECT | GitHub Source Form Property |
GitHub connections read data from the GitHub API and correspond to source |
OBJECT | Google Ads Source Form Property |
Google Ads connections read data from the Google Ads API and correspond to source |
OBJECT | Google CloudSQL MySQL Source Form Property |
A Google CloudSQL MySQL connection reads data from a Google CloudSQL MySQL database and corresponds to source |
OBJECT | Google CloudSQL PostgreSQL Source Form Property |
A Google CloudSQL PostgreSQL connection reads data from a Google CloudSQL PostgreSQL database and corresponds to source |
OBJECT | Harvest Forecast Source Form Property |
Harvest Forecast connections read data from the Harvest Forecast API and correspond to source |
OBJECT | Heap Source Form Property |
Heap connections read data from data dumps in Amazon S3 buckets and correspond to source |
OBJECT | Heroku Source Form Property |
A Heroku connection reads data from a Heroku database and corresponds to source |
OBJECT | HubSpot Source Form Property |
HubSpot connections read data from the HubSpot API and correspond to source |
OBJECT | Intacct Source Form Property |
Intacct connections read data from reports exported to Amazon S3 via ‘s Data Delivery Service feature and correspond to source |
OBJECT | Invoiced Source Form Property |
Invoiced connections read data from the Invoiced API and correspond to source |
OBJECT | Jira Source Form Property |
Jira connections read data from the Jira API and correspond to source |
OBJECT | Listrak Source Form Property |
Listrak connections read data from the Listrak API and correspond to source |
OBJECT | LivePerson Source Form Property |
LivePerson connections read data from the Data Access API
and correspond to source |
OBJECT | MariaDB Source Form Property |
A MariaDB connection reads data from a MariaDB database and corresponds to source |
OBJECT | Marketo Bulk Source Form Property |
Marketo Bulk connections read data from the Marketo Bulk API and correspond to source |
OBJECT | Marketo Source Form Property |
Marketo connections read data from the Marketo API and correspond to source |
OBJECT | Microsoft Azure SQL Data Warehouse Destination Form Property |
A Azure SQL Data Warehouse connection writes data to a Azure SQL Data Warehouse database and corresponds to destination |
OBJECT | Microsoft SQL Server Source Form Property |
A Microsoft SQL Server connection reads data from a Microsoft SQL Server database and corresponds to source |
OBJECT | MySQL Source Form Property |
A MySQL connection reads data from a MySQL database and corresponds to source |
OBJECT | NetSuite Source Form Property |
NetSuite connections read data from the NetSuite SuiteTalk API and correspond to source |
OBJECT | Onfleet Source Form Property |
Onfleet connections read data from the Onfleet API and correspond to source |
OBJECT | Oracle Source Form Property |
An Oracle connection reads data from an Oracle database and corresponds to source |
OBJECT | Pipedrive Source Form Property |
Pipedrive connections read data from the Pipedrive API and correspond to source |
OBJECT | PostgreSQL Destination Form Property |
A PostgreSQL connection writes data to a PostgreSQL database and corresponds to destination |
OBJECT | PostgreSQL Source Form Property |
A PostgreSQL connection reads data from a PostgreSQL database and corresponds to source |
OBJECT | Quick Base Source Form Property |
Quick Base connections read data from the Quick Base API and correspond to source |
OBJECT | Recurly Source Form Property |
Recurly connections read data from the Recurly API and correspond to source |
OBJECT | Redshift Destination Form Property |
A Redshift connection writes data to a Redshift database and corresponds to destination |
OBJECT | Responsys Source Form Property |
A Responsys connection reads data from a Responsys database and corresponds to source |
OBJECT | Revinate Source Form Property |
Revinate connections read data from the Revinate API and correspond to source |
OBJECT | Salesforce Source Form Property |
Salesforce connections read data from the Salesforce API and correspond to source |
OBJECT | SendGrid Source Form Property |
SendGrid connections read data from the SendGrid API and correspond to source |
OBJECT | ShipHero Source Form Property |
ShipHero connections read data from the ShipHero API and correspond to source |
OBJECT | Shopify Source Form Property |
Shopify connections read data from the Shopify API and correspond to source |
OBJECT | Snowflake Destination Form Property |
A Snowflake connection writes data to a Snowflake database and corresponds to destination |
OBJECT | Stripe Source Form Property |
Stripe connections read data from the Stripe API and correspond to source |
OBJECT | Toggl Source Form Property |
Toggl connections read data from the Toggl API and correspond to source |
OBJECT | Typeform Source Form Property |
Typeform connections read data from the Typeform API and correspond to source |
OBJECT | UserVoice Source Form Property |
UserVoice connections read data from the UserVoice API and correspond to source |
OBJECT | Xero Source Form Property |
Xero connections read data from the Xero API and correspond to source |
OBJECT | Yotpo Source Form Property |
Yotpo connections read data from the Yotpo API and correspond to source |
OBJECT | Zendesk Source Form Property |
Zendesk connections read data from the Zendesk API and correspond to source |
OBJECT | Zuora Source Form Property |
Zuora connections read data from the Zuora API and correspond to source |
Destination Form Properties
Destination form properties should be sent in the connection
argument when using the Create or Update a Destination endpoints.
OBJECT | Amazon S3 Destination Form Property |
A Amazon S3 connection writes data to a Amazon S3 database and corresponds to destination |
OBJECT | Microsoft Azure SQL Data Warehouse Destination Form Property |
A Azure SQL Data Warehouse connection writes data to a Azure SQL Data Warehouse database and corresponds to destination |
OBJECT | PostgreSQL Destination Form Property |
A PostgreSQL connection writes data to a PostgreSQL database and corresponds to destination |
OBJECT | Redshift Destination Form Property |
A Redshift connection writes data to a Redshift database and corresponds to destination |
OBJECT | Snowflake Destination Form Property |
A Snowflake connection writes data to a Snowflake database and corresponds to destination |
The Amazon S3 Destination Form Property Object
A Amazon S3 connection writes data to a Amazon S3 database and corresponds to destination type: s3
.
To set up an Amazon S3 destination, users will need to:
- Create a bucket policy that grants Stitch permission to write to the bucket
- Create a “challenge file” in the bucket that allows Stitch to test the connection
Refer to our Amazon S3 documentation for additional details.
Note: Attributes marked as REQUIRED must be provided in the properties
argument for Creating a Destination.
csv_delimiter
STRING OPTIONAL |
Defines the delimiter used if
|
csv_force_quote
BOOLEAN OPTIONAL |
If For example: Numerical fields will appear as |
output_file_format
STRING REQUIRED |
Defines the type of file Stitch will write to the bucket. Possible values are:
For examples of what data will look like in each format, refer to our Amazon S3 documentation. |
s3_bucket
STRING REQUIRED |
The name of the Amazon S3 bucket Stitch will write to. |
s3_key_format_string
STRING REQUIRED |
Defines the naming convention Stitch should use when creating Object Keys. Object Keys are used to name tables when Stitch writes to the bucket. The required elements for an Object Key are:
For more info on construcing an S3 Object Key, refer to our Amazon S3 documentation. |
sentinel_key
STRING OPTIONAL |
Note: This should not be submitted when creating a destination. This value will be returned as part of successfully creating an Amazon S3 destination. The sentinel key is the name the challenge file in the bucket must have. The challenge file is a blank file that Stitch uses to test the permissions for the bucket. This file must remain in the bucket even after the inital setup is complete. Refer to our Amazon S3 documentation for additional details. |
Example Object
The Microsoft Azure SQL Data Warehouse Destination Form Property Object
A Azure SQL Data Warehouse connection writes data to a Azure SQL Data Warehouse database and corresponds to destination type: azuresql_dw
.
Note: Attributes marked as REQUIRED must be provided in the properties
argument for Creating a Destination.
azure_storage_account_token
STRING REQUIRED |
An Azure Storage Access Key. This is used to access Azure Blob Storage, which Stitch uses to stage data for Polybase before loading it into an Azure SQL Data Warehouse destination. For more info and instructions for generating this credential, refer to our Azure SQL Data Warehouse setup documentation. |
azure_storage_sas_url
STRING REQUIRED |
An Azure Blob service Shared Access Signature (SAS) URL, which is used to grant Stitch restricted access to Azure Storage resources. These resources are used to load data into an Azure SQL Data Warehouse destination. For more info and instructions for generating this credential, refer to our Azure SQL Data Warehouse setup documentation. |
database
STRING REQUIRED |
The name of the logical database to connect to. |
encryption_host
STRING OPTIONAL |
If using SSH encryption, the host of the SSH server. Required only if |
encryption_port
STRING OPTIONAL |
If using SSH encryption, the port of the SSH server. Required only if |
encryption_type
STRING REQUIRED |
Indicates that SSH encryption should be used to connect to the destination. Valid values are:
|
encryption_username
STRING OPTIONAL |
If using SSH encryption, the name of the SSH user. Required only if |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
STRING REQUIRED |
The port of the database server. The default is |
ssl
BOOLEAN OPTIONAL |
If |
user
STRING REQUIRED |
The username of the database user. |
Example Object
The PostgreSQL Destination Form Property Object
A PostgreSQL connection writes data to a PostgreSQL database and corresponds to destination type: postgres
.
Note: Attributes marked as REQUIRED must be provided in the properties
argument for Creating a Destination.
database
STRING REQUIRED |
The name of the logical database to connect to. |
encryption_host
STRING OPTIONAL |
If using SSH encryption, the host of the SSH server. Required only if |
encryption_port
STRING OPTIONAL |
If using SSH encryption, the port of the SSH server. Required only if |
encryption_type
STRING REQUIRED |
Indicates that SSH encryption should be used to connect to the destination. Valid values are:
|
encryption_username
STRING OPTIONAL |
If using SSH encryption, the name of the SSH user. Required only if |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
STRING REQUIRED |
The port of the database server. The default is |
ssl
BOOLEAN OPTIONAL |
If |
sslrootcert
STRING OPTIONAL |
Optional: The certificate (typically a CA or server certificate) Stitch should verify the SSL connection against. The connection will succeed only if the server’s certificate verifies against the certificate provided. Note: Providing a certificate via this property isn’t required to use SSL. This is only if Stitch should verify the connection against a specific certificate. |
user
STRING REQUIRED |
The username of the database user. |
Example Object
The Redshift Destination Form Property Object
A Redshift connection writes data to a Redshift database and corresponds to destination type: redshift
.
Note: Attributes marked as REQUIRED must be provided in the properties
argument for Creating a Destination.
database
STRING REQUIRED |
The name of the logical database to connect to. |
encryption_host
STRING OPTIONAL |
If using SSH encryption, the host of the SSH server. Required only if |
encryption_port
STRING OPTIONAL |
If using SSH encryption, the port of the SSH server. Required only if |
encryption_type
STRING REQUIRED |
Indicates that SSH encryption should be used to connect to the destination. Valid values are:
|
encryption_username
STRING OPTIONAL |
If using SSH encryption, the name of the SSH user. Required only if |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
STRING REQUIRED |
The port of the database server. The default is |
ssl
BOOLEAN OPTIONAL |
If |
user
STRING REQUIRED |
The username of the database user. |
Example Object
The Snowflake Destination Form Property Object
A Snowflake connection writes data to a Snowflake database and corresponds to destination type: snowflake
.
Note: Attributes marked as REQUIRED must be provided in the properties
argument for Creating a Destination.
database
STRING REQUIRED |
The name of the logical database to connect to. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
STRING REQUIRED |
The port of the database server. The default is |
role
STRING OPTIONAL |
The role to use. |
ssl
BOOLEAN OPTIONAL |
If |
user
STRING REQUIRED |
The username of the database user. |
warehouse
STRING REQUIRED |
The name of the Snowflake warehouse Stitch will connect to. |
Example Object
Source Form Properties
Source form properties should be sent in the properties
argument when using the Create or Update a Source endpoints.
All properties should be sent as strings.
OBJECT | Amazon Aurora Source Form Property |
An Amazon Aurora connection reads data from an Amazon Aurora database and corresponds to source |
OBJECT | Amazon S3 CSV Source Form Property |
An Amazon S3 CSV connection reads data from an Amazon S3 CSV database and corresponds to source |
OBJECT | Amplitude Source Form Property |
Amplitude connections read data from the Amplitude API and correspond to source |
OBJECT | Asana Source Form Property |
Asana connections read data from the Asana API and correspond to source |
OBJECT | BigCommerce Source Form Property |
BigCommerce connections read data from the BigCommerce API and correspond to source |
OBJECT | Bing Ads Source Form Property |
Bing Ads connections read data from the Bing Ads API and correspond to source |
OBJECT | Bronto Source Form Property |
Bronto connections read data from the Bronto API and correspond to source |
OBJECT | Campaign Manager Source Form Property |
Campaign Manager connections read data from the Campaign Manager API and correspond to source |
OBJECT | Campaign Monitor Source Form Property |
Campaign Monitor connections read data from the Campaign Monitor API and correspond to source |
OBJECT | Chargebee Source Form Property |
Chargebee connections read data from the Chargebee API and correspond to source |
OBJECT | Close.io Source Form Property |
Close.io connections read data from the Close.io API and correspond to source |
OBJECT | Club Speed Source Form Property |
Club Speed connections read data from the Club Speed API and correspond to source |
OBJECT | Codat Source Form Property |
Codat connections read data from the Codat API and correspond to source |
OBJECT | Eloqua Source Form Property |
Eloqua connections read data from the Bulk and REST APIs
and correspond to source |
OBJECT | Facebook Ads Source Form Property |
Facebook Ads connections read data from the Facebook Ads API and correspond to source |
OBJECT | Front Source Form Property |
Front connections read data from the Front API and correspond to source |
OBJECT | FullStory Source Form Property |
FullStory connections read data from the FullStory API and correspond to source |
OBJECT | GitHub Source Form Property |
GitHub connections read data from the GitHub API and correspond to source |
OBJECT | Google Ads Source Form Property |
Google Ads connections read data from the Google Ads API and correspond to source |
OBJECT | Google CloudSQL MySQL Source Form Property |
A Google CloudSQL MySQL connection reads data from a Google CloudSQL MySQL database and corresponds to source |
OBJECT | Google CloudSQL PostgreSQL Source Form Property |
A Google CloudSQL PostgreSQL connection reads data from a Google CloudSQL PostgreSQL database and corresponds to source |
OBJECT | Harvest Forecast Source Form Property |
Harvest Forecast connections read data from the Harvest Forecast API and correspond to source |
OBJECT | Heap Source Form Property |
Heap connections read data from data dumps in Amazon S3 buckets and correspond to source |
OBJECT | Heroku Source Form Property |
A Heroku connection reads data from a Heroku database and corresponds to source |
OBJECT | HubSpot Source Form Property |
HubSpot connections read data from the HubSpot API and correspond to source |
OBJECT | Intacct Source Form Property |
Intacct connections read data from reports exported to Amazon S3 via ‘s Data Delivery Service feature and correspond to source |
OBJECT | Invoiced Source Form Property |
Invoiced connections read data from the Invoiced API and correspond to source |
OBJECT | Jira Source Form Property |
Jira connections read data from the Jira API and correspond to source |
OBJECT | Listrak Source Form Property |
Listrak connections read data from the Listrak API and correspond to source |
OBJECT | LivePerson Source Form Property |
LivePerson connections read data from the Data Access API
and correspond to source |
OBJECT | MariaDB Source Form Property |
A MariaDB connection reads data from a MariaDB database and corresponds to source |
OBJECT | Marketo Bulk Source Form Property |
Marketo Bulk connections read data from the Marketo Bulk API and correspond to source |
OBJECT | Marketo Source Form Property |
Marketo connections read data from the Marketo API and correspond to source |
OBJECT | Microsoft SQL Server Source Form Property |
A Microsoft SQL Server connection reads data from a Microsoft SQL Server database and corresponds to source |
OBJECT | MySQL Source Form Property |
A MySQL connection reads data from a MySQL database and corresponds to source |
OBJECT | NetSuite Source Form Property |
NetSuite connections read data from the NetSuite SuiteTalk API and correspond to source |
OBJECT | Onfleet Source Form Property |
Onfleet connections read data from the Onfleet API and correspond to source |
OBJECT | Oracle Source Form Property |
An Oracle connection reads data from an Oracle database and corresponds to source |
OBJECT | Pipedrive Source Form Property |
Pipedrive connections read data from the Pipedrive API and correspond to source |
OBJECT | PostgreSQL Source Form Property |
A PostgreSQL connection reads data from a PostgreSQL database and corresponds to source |
OBJECT | Quick Base Source Form Property |
Quick Base connections read data from the Quick Base API and correspond to source |
OBJECT | Recurly Source Form Property |
Recurly connections read data from the Recurly API and correspond to source |
OBJECT | Responsys Source Form Property |
A Responsys connection reads data from a Responsys database and corresponds to source |
OBJECT | Revinate Source Form Property |
Revinate connections read data from the Revinate API and correspond to source |
OBJECT | Salesforce Source Form Property |
Salesforce connections read data from the Salesforce API and correspond to source |
OBJECT | SendGrid Source Form Property |
SendGrid connections read data from the SendGrid API and correspond to source |
OBJECT | ShipHero Source Form Property |
ShipHero connections read data from the ShipHero API and correspond to source |
OBJECT | Shopify Source Form Property |
Shopify connections read data from the Shopify API and correspond to source |
OBJECT | Stripe Source Form Property |
Stripe connections read data from the Stripe API and correspond to source |
OBJECT | Toggl Source Form Property |
Toggl connections read data from the Toggl API and correspond to source |
OBJECT | Typeform Source Form Property |
Typeform connections read data from the Typeform API and correspond to source |
OBJECT | UserVoice Source Form Property |
UserVoice connections read data from the UserVoice API and correspond to source |
OBJECT | Xero Source Form Property |
Xero connections read data from the Xero API and correspond to source |
OBJECT | Yotpo Source Form Property |
Yotpo connections read data from the Yotpo API and correspond to source |
OBJECT | Zendesk Source Form Property |
Zendesk connections read data from the Zendesk API and correspond to source |
OBJECT | Zuora Source Form Property |
Zuora connections read data from the Zuora API and correspond to source |
The Amazon Aurora Source Form Property Object
An Amazon Aurora connection reads data from an Amazon Aurora database and corresponds to source type: platform.aurora
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
allow_non_auto_increment_pks
STRING OPTIONAL |
If Unless set, this property will default to |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
database
STRING OPTIONAL |
The name of the logical database to connect to. |
filter_dbs
STRING OPTIONAL |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Amazon Aurora. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
server_id
STRING OPTIONAL |
Defines the unique ID of the server that Stitch will connect to, if using Log-based (binlog) Replication. Server IDs must be unique, as MySQL doesn’t allow replication to simultaneously occur across multiple connections using the same server ID. For more info about this setting in Stitch, refer to the MySQL documentation. |
ssh
STRING OPTIONAL |
If |
ssh_host
STRING OPTIONAL |
The IP address or hostname of the SSH server. This property is only required if |
ssh_port
STRING OPTIONAL |
The port of the SSH server. This property is only required if |
ssh_user
STRING OPTIONAL |
The username of the SSH user. This property is only required if |
ssl
STRING OPTIONAL |
If |
use_log_based_replication
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the Amazon Aurora database user. |
Example Object
The Amazon S3 CSV Source Form Property Object
An Amazon S3 CSV connection reads data from an Amazon S3 CSV database and corresponds to source type: platform.s3-csv
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
account_id
STRING REQUIRED |
The user’s Amazon Web Services (AWS) Account ID. Refer to the Amazon S3 CSV documentation for more info. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
bucket
STRING REQUIRED |
The name of the bucket Stitch should replicate data from. This value should not contain any URLs, |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
external_id
STRING REQUIRED |
The external ID associated with the Amazon Web Services (AWS) Identity Access Management (IAM) role used by Stitch. In AWS, external IDs are used to increase role security when granting access to accounts that you don’t own or have administrative access to. Stitch will provide this ID when accessing Amazon S3 CSV. This value can be anything, but it must be the same as the external ID provided in the AWS console when creating the Stitch IAM role. Refer to the Amazon S3 CSV documentation for more info. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Amazon S3 CSV. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
role_name
STRING REQUIRED |
The name of the AWS IAM role Stitch should assume when extracting data from Amazon S3. This role will have the permissions in the IAM policy associated with the role. Refer to our Amazon S3 CSV documentation for more info about the IAM policy, role, and how to create them in AWS. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Amazon S3 CSV. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
tables
STRING REQUIRED |
A series of properties defining the CSV files to be tracked as tables. For every table configuration, this property will contain a JSON object with the following properties. Every property should be a string.
|
Example Object
The Amplitude Source Form Property Object
Amplitude connections read data from the Amplitude API and correspond to source type: platform.amplitude
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
account
STRING REQUIRED |
The account ID for the Amplitude Snowflake warehouse. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Amplitude. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Amplitude. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
username
STRING REQUIRED |
The username of the Amplitude database user. |
warehouse
STRING REQUIRED |
The name of the Amplitude Snowflake warehouse. |
Example Object
The Asana Source Form Property Object
Asana connections read data from the Asana API and correspond to source type: platform.asana
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Asana. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The BigCommerce Source Form Property Object
BigCommerce connections read data from the BigCommerce API and correspond to source type: platform.bigcommerce
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
access_token
STRING REQUIRED |
The user’s BigCommerce API access token. Refer to the BigCommerce documentation for instructions on retrieving this credential. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
client_id
STRING REQUIRED |
The user’s BigCommerce API client ID. Refer to the BigCommerce documentation for instructions on retrieving this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from BigCommerce. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from BigCommerce. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
store_hash
STRING REQUIRED |
The user’s BigCommerce store hash. Refer to the BigCommerce documentation for instructions on retrieving this credential. |
Example Object
The Bing Ads Source Form Property Object
Bing Ads connections read data from the Bing Ads API and correspond to source type: platform.bing-ads
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Bing Ads. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Bronto Source Form Property Object
Bronto connections read data from the Bronto API and correspond to source type: platform.bronto
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Bronto. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Bronto. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
token
STRING REQUIRED |
The API token for the Bronto account Stitch should replicate data from. |
Example Object
The Campaign Manager Source Form Property Object
Campaign Manager connections read data from the Campaign Manager API and correspond to source type: platform.doubleclick-campaign-manager
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Campaign Manager. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Campaign Monitor Source Form Property Object
Campaign Monitor connections read data from the Campaign Monitor API and correspond to source type: platform.campaign-monitor
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
client_id
STRING REQUIRED |
The user’s Campaign Monitor API client ID. This can be found in the Campaign Monitor app in Account Settings > API keys. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Campaign Monitor. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Campaign Monitor. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Chargebee Source Form Property Object
Chargebee connections read data from the Chargebee API and correspond to source type: platform.chargebee
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s Chargebee API key. Refer to the Chargebee documentation for info on generating this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Chargebee. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
site
STRING REQUIRED |
The name of the user’s Chargebee site. This can be found in the Chargebee site URL. For example: If the URL was |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Chargebee. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Close.io Source Form Property Object
Close.io connections read data from the Close.io API and correspond to source type: platform.closeio
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s API key. API keys can be generated in by navigating to Settings > Your API Keys. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Close.io. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Close.io. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Club Speed Source Form Property Object
Club Speed connections read data from the Club Speed API and correspond to source type: platform.clubspeed
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Club Speed. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
private_key
STRING REQUIRED |
The user’s Club Speed private API key. The user will need to contact Club Speed support to obtain this credential. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Club Speed. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
subdomain
STRING REQUIRED |
The user’s Club Speed subdomain. For example: If the full URL is |
Example Object
The Codat Source Form Property Object
Codat connections read data from the Codat API and correspond to source type: platform.codat
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s Codat API key. Refer to the Codat documentation for instructions on retrieving this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Codat. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Codat. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
uat_urls
STRING OPTIONAL |
Indicates whether the instance being connected is a UAT (sandbox) instance or not. |
Example Object
The Eloqua Source Form Property Object
Eloqua connections read data from the Eloqua Bulk and REST APIs
and correspond to source type: platform.eloqua
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
bulk_page_size
STRING OPTIONAL |
The number of records each page in a bulk export should contain. Note: This setting only affects streams that use the Eloqua Bulk API. Refer to the Eloqua documentation for info about how each stream is replicated. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Eloqua. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Eloqua. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Facebook Ads Source Form Property Object
Facebook Ads connections read data from the Facebook Ads API and correspond to source type: platform.facebook
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
attribution_window
STRING OPTIONAL |
Defines the number, in days, Stitch should use as an attribution window. An attribution window is the period of time for attributing results to ads and the lookback period after those actions occur during which ad results are counted. Accepted values, in days:
To ensure your Facebook Ads and Stitch settings align, we recommend using the same attribution window in Stitch that you use in Facebook Ads. For example: If the attribution window is 28 days in Facebook, this value should be If your click and view windows differ, you should select the greater of the two. For example: If clicks have a window of |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Facebook Ads. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
include_deleted
STRING OPTIONAL |
If |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Facebook Ads. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Front Source Form Property Object
Front connections read data from the Front API and correspond to source type: platform.frontapp
.
Note: To use this integration, the user must have a Premium or Enterprise Front plan. These plans include API access, which is required to use Stitch’s Front integration.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Front. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
incremental_range
STRING REQUIRED |
Defines how data will be aggregated. Accepted values are |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Front. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
token
STRING REQUIRED |
The user’s Front API token. Refer to the Front setup guide for instructions on how to generate this token. |
Example Object
The FullStory Source Form Property Object
FullStory connections read data from the FullStory API and correspond to source type: platform.fullstory
.
Note: To use this integration, the user must have a FullStory account with the FullStory Data Export Pack add-on. This is a paid addition that allows users to export raw event data, and is required to use FullStory’s Data Export REST API.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
A FullStory API key, used to authenticate to FullStory’s Data Export API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from FullStory. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from FullStory. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The GitHub Source Form Property Object
GitHub connections read data from the GitHub API and correspond to source type: platform.github
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
access_token
STRING REQUIRED |
An access token which allows access to any project the user wants to replicate data from. Note: This access token must have the |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from GitHub. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
repository
STRING REQUIRED |
The path or paths of the repository or repositories to be tracked. A repository path is relative to To track multiple repositories, this value should be a space delimited list of the repository paths. For example:
|
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from GitHub. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Google Ads Source Form Property Object
Google Ads connections read data from the Google Ads API and correspond to source type: platform.adwords
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Google Ads. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Google CloudSQL MySQL Source Form Property Object
A Google CloudSQL MySQL connection reads data from a Google CloudSQL MySQL database and corresponds to source type: platform.cloudsql
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
allow_non_auto_increment_pks
STRING OPTIONAL |
If Unless set, this property will default to |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
database
STRING OPTIONAL |
The name of the logical database to connect to. |
filter_dbs
STRING OPTIONAL |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Google CloudSQL MySQL. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
server_id
STRING OPTIONAL |
Defines the unique ID of the server that Stitch will connect to, if using Log-based (binlog) Replication. Server IDs must be unique, as MySQL doesn’t allow replication to simultaneously occur across multiple connections using the same server ID. For more info about this setting in Stitch, refer to the MySQL documentation. |
use_log_based_replication
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the Google CloudSQL MySQL database user. |
Example Object
The Google CloudSQL PostgreSQL Source Form Property Object
A Google CloudSQL PostgreSQL connection reads data from a Google CloudSQL PostgreSQL database and corresponds to source type: platform.cloudsql_pg
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
dbname
STRING REQUIRED |
The name of the logical database to connect to. |
filter_dbs
STRING REQUIRED |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Google CloudSQL PostgreSQL. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
include_schemas_in_destination_stream_name
STRING REQUIRED |
If For more info, refer to the Database Integration Table Name Collisions guide. |
itersize
STRING REQUIRED |
This is an internal field and is for Stitch use only. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
user
STRING REQUIRED |
The username of the Google CloudSQL PostgreSQL database user. |
Example Object
The Harvest Forecast Source Form Property Object
Harvest Forecast connections read data from the Harvest Forecast API and correspond to source type: platform.harvest-forecast
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Harvest Forecast. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Heap Source Form Property Object
Heap connections read data from data dumps in Amazon S3 buckets and correspond to source type: platform.heap
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
account_id
STRING REQUIRED |
The user’s Amazon Web Services account ID. Refer to the Heap documentation for instructions on retrieving this info. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
bucket
STRING REQUIRED |
The name of the bucket Stitch should replicate Heap data from. Heap requires that bucket names be prefixed with |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
external_id
STRING REQUIRED |
The external ID associated with the Amazon Web Services (AWS) Identity Access Management (IAM) role used by Stitch. In AWS, external IDs are used to increase role security when granting access to accounts that you don’t own or have administrative access to. Stitch will provide this ID when accessing Heap. This value can be anything, but it must be the same as the external ID provided in the AWS console when creating the Stitch IAM role. Refer to the Heap documentation for more info. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Heap. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
role_name
STRING REQUIRED |
The name of the AWS IAM role Stitch should assume when extracting data from Amazon S3. This role will have the permissions in the IAM policy associated with the role. This value can be anything, but it must be the same as the role name provided in the AWS console when creating the Stitch IAM role. Refer to the Heap documentation for more info. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Heap. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Heroku Source Form Property Object
A Heroku connection reads data from a Heroku database and corresponds to source type: platform.heroku_pg
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
dbname
STRING REQUIRED |
The name of the logical database to connect to. |
filter_dbs
STRING REQUIRED |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Heroku. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
include_schemas_in_destination_stream_name
STRING REQUIRED |
If For more info, refer to the Database Integration Table Name Collisions guide. |
itersize
STRING REQUIRED |
This is an internal field and is for Stitch use only. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
ssl
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the Heroku database user. |
Example Object
The HubSpot Source Form Property Object
HubSpot connections read data from the HubSpot API and correspond to source type: platform.hubspot
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from HubSpot. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Intacct Source Form Property Object
Intacct connections read data from reports exported to Amazon S3 via Intacct’s Data Delivery Service feature and correspond to source type: platform.intacct
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
account_id
STRING REQUIRED |
The user’s Amazon Web Services account ID. Refer to the Intacct documentation for instructions on retrieving this info. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
bucket
STRING REQUIRED |
The name of the bucket Stitch should replicate Intacct data from. This value should only include the bucket name: No URLs, |
company_id
STRING REQUIRED |
The user’s Intacct company ID, used to sign into Intacct. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
external_id
STRING REQUIRED |
The external ID associated with the Amazon Web Services (AWS) Identity Access Management (IAM) role used by Stitch. In AWS, external IDs are used to increase role security when granting access to accounts that you don’t own or have administrative access to. Stitch will provide this ID when accessing Intacct. This value can be anything, but it must be the same as the external ID provided in the AWS console when creating the Stitch IAM role. Refer to the Intacct documentation for more info. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Intacct. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
path
STRING OPTIONAL |
Optional: The path configured in Intacct for use in the S3 bucket. |
role_name
STRING REQUIRED |
The name of the AWS IAM role Stitch should assume when extracting data from Amazon S3. This role will have the permissions in the IAM policy associated with the role. This value can be anything, but it must be the same as the role name provided in the AWS console when creating the Stitch IAM role. Refer to the Intacct documentation for more info. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Intacct. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Invoiced Source Form Property Object
Invoiced connections read data from the Invoiced API and correspond to source type: platform.invoiced
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s Invoiced API key. Refer to the Invoiced documentation for instructions on generating this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Invoiced. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
sandbox
STRING OPTIONAL |
If |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Invoiced. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Jira Source Form Property Object
Jira connections read data from the Jira API and correspond to source type: platform.jira
.
Stitch’s Jira source can connect to self-managed (hosted) or cloud-hosted instances. Note: The steps for connecting each type of instance vary. Refer to our JIRA documentation for more info.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
base_url
STRING REQUIRED |
The base URL for the user’s Jira instance. Note: If connecting a self-managed (hosted) instance, the server must use the |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Jira. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
password
STRING REQUIRED |
Depending on the type of Jira instance being connected, this value should be one of the following:
|
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Jira. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
username
STRING REQUIRED |
The user’s Jira username. This will typically be the email address the user uses to sign into Jira. |
Example Object
The Listrak Source Form Property Object
Listrak connections read data from the Listrak API and correspond to source type: platform.listrak
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Listrak. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
password
STRING REQUIRED |
The password associated with the Listrak user. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Listrak. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
username
STRING REQUIRED |
The user’s Listrak username. |
Example Object
The LivePerson Source Form Property Object
LivePerson connections read data from the LivePerson Data Access API
and correspond to source type: platform.liveperson
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
access_token
STRING REQUIRED |
The user’s LivePerson API access token. Refer to the LivePerson documentation for instructions on creating this credential. |
access_token_secret
STRING REQUIRED |
The user’s LivePerson API access token secret. Refer to the LivePerson documentation for instructions on creating this credential. |
account_id
STRING REQUIRED |
The user’s LivePerson account ID. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
app_key
STRING REQUIRED |
The user’s LivePerson API app key. Refer to the LivePerson documentation for instructions on creating this credential. |
app_secret
STRING REQUIRED |
The user’s LivePerson API app secret. Refer to the LivePerson documentation for instructions on creating this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from LivePerson. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from LivePerson. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The MariaDB Source Form Property Object
A MariaDB connection reads data from a MariaDB database and corresponds to source type: platform.mariadb
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
allow_non_auto_increment_pks
STRING OPTIONAL |
If Unless set, this property will default to |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
database
STRING OPTIONAL |
The name of the logical database to connect to. |
filter_dbs
STRING OPTIONAL |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from MariaDB. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
server_id
STRING OPTIONAL |
Defines the unique ID of the server that Stitch will connect to, if using Log-based (binlog) Replication. Server IDs must be unique, as MySQL doesn’t allow replication to simultaneously occur across multiple connections using the same server ID. For more info about this setting in Stitch, refer to the MySQL documentation. |
ssh
STRING OPTIONAL |
If |
ssh_host
STRING OPTIONAL |
The IP address or hostname of the SSH server. This property is only required if |
ssh_port
STRING OPTIONAL |
The port of the SSH server. This property is only required if |
ssh_user
STRING OPTIONAL |
The username of the SSH user. This property is only required if |
ssl
STRING OPTIONAL |
If |
use_log_based_replication
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the MariaDB database user. |
Example Object
The Marketo Bulk Source Form Property Object
Marketo Bulk connections read data from the Marketo Bulk API and correspond to source type: platform.marketobulk
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
client_id
STRING REQUIRED |
The user’s Marketo client ID. |
client_secret
STRING REQUIRED |
The user’s Marketo client secret. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
endpoint
STRING REQUIRED |
The user’s Marketo REST endpoint URL. For example: |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Marketo Bulk. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Marketo Bulk. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Marketo Source Form Property Object
Marketo connections read data from the Marketo API and correspond to source type: platform.marketo
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
client_id
STRING REQUIRED |
The user’s Marketo client ID. |
client_secret
STRING REQUIRED |
The user’s Marketo client secret. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
endpoint
STRING REQUIRED |
The user’s Marketo REST endpoint URL. For example: |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Marketo. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
identity
STRING REQUIRED |
The user’s Marketo REST identity URL. For example: |
max_daily_calls
STRING OPTIONAL |
The maximum number of daily API calls that Stitch may make to the Marketo API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Marketo. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Microsoft SQL Server Source Form Property Object
A Microsoft SQL Server connection reads data from a Microsoft SQL Server database and corresponds to source type: platform.mssql
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
database
STRING OPTIONAL |
The name of the logical database to connect to. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Microsoft SQL Server. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
ssh
STRING OPTIONAL |
If |
ssh_host
STRING OPTIONAL |
The IP address or hostname of the SSH server. This property is only required if |
ssh_port
STRING OPTIONAL |
The port of the SSH server. This property is only required if |
ssh_user
STRING OPTIONAL |
The username of the SSH user. This property is only required if |
ssl
STRING OPTIONAL |
If |
use_log_based_replication
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the Microsoft SQL Server database user. |
Example Object
The MySQL Source Form Property Object
A MySQL connection reads data from a MySQL database and corresponds to source type: platform.mysql
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
allow_non_auto_increment_pks
STRING OPTIONAL |
If Unless set, this property will default to |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
check_hostname
STRING OPTIONAL |
Optional: This property works with the
Note: If the user doesn’t want to use a custom CA, this property and the |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
database
STRING OPTIONAL |
The name of the logical database to connect to. |
filter_dbs
STRING OPTIONAL |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from MySQL. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
server_id
STRING OPTIONAL |
Defines the unique ID of the server that Stitch will connect to, if using Log-based (binlog) Replication. Server IDs must be unique, as MySQL doesn’t allow replication to simultaneously occur across multiple connections using the same server ID. For more info about this setting in Stitch, refer to the MySQL documentation. |
ssh
STRING OPTIONAL |
If |
ssh_host
STRING OPTIONAL |
The IP address or hostname of the SSH server. This property is only required if |
ssh_port
STRING OPTIONAL |
The port of the SSH server. This property is only required if |
ssh_user
STRING OPTIONAL |
The username of the SSH user. This property is only required if |
ssl
STRING OPTIONAL |
If |
ssl_ca
STRING OPTIONAL |
Optional: The certificate (typically a CA or server certificate) Stitch should verify the SSL connection against. The connection will succeed only if the server’s certifcate verifies against the certificate provided. Note: Providing a certifcate via this property isn’t required to use SSL. This is only if Stitch should verify the connection against a specific certificate. |
ssl_cert
STRING OPTIONAL |
Optional: If |
ssl_client_auth_enabled
STRING OPTIONAL |
Optional: Indicates if SSL client authentication should be used. Accepted values are:
|
ssl_key
STRING OPTIONAL |
Optional: If |
use_log_based_replication
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the MySQL database user. |
verify_mode
STRING OPTIONAL |
Optional: SSL certificate verification is enabled when a Certificate Authority (CA) is provided. If
Note: If the user doesn’t want to use a custom CA, this property and the |
Example Object
The NetSuite Source Form Property Object
NetSuite connections read data from the NetSuite SuiteTalk API and correspond to source type: platform.netsuite
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
account
STRING REQUIRED |
The user’s NetSuite account ID. If the account ID includes a suffix, it should be included. For example: Refer to the NetSuite documentation for instructions on retrieving this info. |
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
consumer_key
STRING REQUIRED |
The consumer key for Stitch’s integration record in the user’s NetSuite account. This is used when performing token-based authentication to NetSuite. Refer to the NetSuite documentation for instructions on retrieving this info. |
consumer_secret
STRING REQUIRED |
The consumer secret for Stitch’s integration record in the user’s NetSuite account. This is used when performing token-based authentication to NetSuite. Refer to the NetSuite documentation for instructions on retrieving this info. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from NetSuite. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from NetSuite. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
token_id
STRING REQUIRED |
The token ID, created as part of generating access tokens for Stitch’s integration record in the user’s NetSuite account. This is used when performing token-based authentication to NetSuite. Refer to the NetSuite documentation for instructions on retrieving this info. |
token_secret
STRING REQUIRED |
The token secret, created as part of generating access tokens for Stitch’s integration record in the user’s NetSuite account. This is used when performing token-based authentication to NetSuite. Refer to the NetSuite documentation for instructions on retrieving this info. |
Example Object
The Onfleet Source Form Property Object
Onfleet connections read data from the Onfleet API and correspond to source type: platform.onfleet
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s Onfleet API key. Refer to the Onfleet documentation for instructions on creating this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Onfleet. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
quota_limit
STRING REQUIRED |
The percentage of the Onfleet API quota Stitch is allowed to use for this connection. Onfleet limits API requests to 20 requests per second across all API keys in a given Onfleet account. For example: If this value is |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Onfleet. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Oracle Source Form Property Object
An Oracle connection reads data from an Oracle database and corresponds to source type: platform.oracle
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
default_replication_method
STRING REQUIRED |
The replication method to be used as the default method for tables set to replicate. Accepted values are:
|
filter_schemas
STRING OPTIONAL |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Oracle. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
sid
STRING REQUIRED |
The database’s Oracle System ID (SID). A SID is used to uniquely identify a specific database in Oracle. |
ssh
STRING OPTIONAL |
If |
ssh_host
STRING OPTIONAL |
The IP address or hostname of the SSH server. This property is only required if |
ssh_port
STRING OPTIONAL |
The port of the SSH server. This property is only required if |
ssh_user
STRING OPTIONAL |
The username of the SSH user. This property is only required if |
ssl
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the Oracle database user. |
Example Object
The Pipedrive Source Form Property Object
Pipedrive connections read data from the Pipedrive API and correspond to source type: platform.pipedrive
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_token
STRING REQUIRED |
A Pipedrive API token, used to authenticate to Pipedrive’s API. Note: In Pipedrive, API tokens are unique to each Pipedrive user. The API token provided should be associated with a Pipedrive user with Admin permissions, which will ensure Stitch can successfully access and replicate all data from Pipedrive. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Pipedrive. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Pipedrive. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The PostgreSQL Source Form Property Object
A PostgreSQL connection reads data from a PostgreSQL database and corresponds to source type: platform.postgres
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
dbname
STRING REQUIRED |
The name of the logical database to connect to. |
debug_lsn
STRING OPTIONAL |
This is an internal field and is for Stitch use only. |
filter_dbs
STRING REQUIRED |
This is an internal field and is for Stitch use only. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from PostgreSQL. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The IP address or hostname of the database server. |
include_schemas_in_destination_stream_name
STRING REQUIRED |
If For more info, refer to the Database Integration Table Name Collisions guide. |
itersize
STRING REQUIRED |
This is an internal field and is for Stitch use only. |
logical_poll_total_seconds
STRING OPTIONAL |
The total amount of time, in seconds, that the integration should be allowed to poll for records while performing Log-based Incremental Replication. |
password
STRING REQUIRED |
The password for the user connecting to the database server. Note: This property will never be returned by the API, but it can be submitted when creating or modifying a connection. |
port
INTEGER REQUIRED |
The port of the database server. The default is |
ssh
STRING OPTIONAL |
If |
ssh_host
STRING OPTIONAL |
The IP address or hostname of the SSH server. This property is only required if |
ssh_port
STRING OPTIONAL |
The port of the SSH server. This property is only required if |
ssh_user
STRING OPTIONAL |
The username of the SSH user. This property is only required if |
ssl
STRING OPTIONAL |
If |
user
STRING REQUIRED |
The username of the PostgreSQL database user. |
Example Object
The Quick Base Source Form Property Object
Quick Base connections read data from the Quick Base API and correspond to source type: platform.quickbase
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Quick Base. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
qb_appid
STRING REQUIRED |
The ID of the Quick Base app the user wants to connect. This is a unique alpha-numeric string that can be found in the app’s URL when the user is logged into Quick Base. For example: If the app URL is |
qb_url
STRING REQUIRED |
The URL of the user’s Quick Base realm. This value must include the For example: If the realm URL is |
qb_user_token
STRING REQUIRED |
The user’s Quick Base user token. Refer to Stitch’s Quick Base documentation for creation instructions. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Quick Base. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Recurly Source Form Property Object
Recurly connections read data from the Recurly API and correspond to source type: platform.recurly
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s Recurly API key. Refer to the Recurly documentation for instructions on generating this credential. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Recurly. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
quota_limit
STRING REQUIRED |
The percentage of the API rate limit that should be allocated to Stitch replicating from Recurly. For example: A value of |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Recurly. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
subdomain
STRING REQUIRED |
The user’s Recurly subdomain. For example: If the full URL were |
Example Object
The Responsys Source Form Property Object
A Responsys connection reads data from a Responsys database and corresponds to source type: platform.responsys
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Responsys. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
host
STRING REQUIRED |
The host address of the Responsys SFTP server. If the server is hosted by Oracle, this will likely be |
path
STRING REQUIRED |
The file server path where completed Responsys export files are stored. |
port
STRING REQUIRED |
The port of the SFTP server. As Stitch uses an SSH tunnel to connect to Responsys, this will likely be the default SSH port ( |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Responsys. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
username
STRING REQUIRED |
The username of the Responsys database user. |
Example Object
The Revinate Source Form Property Object
Revinate connections read data from the Revinate API and correspond to source type: revinate
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The user’s Revinate API key. The user can obtain this by contacting their Revinate sales representative or account manager. |
api_secret
STRING REQUIRED |
The user’s Revinate API secret. The user can obtain this by contacting their Revinate sales representative or account manager. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Revinate. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Revinate. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
username
STRING REQUIRED |
The user’s Revinate username. |
Example Object
The Salesforce Source Form Property Object
Salesforce connections read data from the Salesforce API and correspond to source type: platform.salesforce
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_type
STRING REQUIRED |
The Salesforce API Stitch should use to extract data. Possible values are |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Salesforce. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
is_sandbox
STRING OPTIONAL |
If |
quota_percent_per_run
STRING OPTIONAL |
The maximum percentage of Salesforce API quota allowed per replication job. |
quota_percent_total
STRING OPTIONAL |
The maximum percentage of Salesforce API quota allowed per day. |
select_fields_by_default
STRING REQUIRED |
If |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Salesforce. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The SendGrid Source Form Property Object
SendGrid connections read data from the SendGrid API and correspond to source type: platform.sendgrid
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The SendGrid API key. Refer to SendGrid’s documentation for info about permissions and creating keys. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from SendGrid. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from SendGrid. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The ShipHero Source Form Property Object
ShipHero connections read data from the ShipHero API and correspond to source type: platform.shiphero
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_token
STRING REQUIRED |
A ShipHero API token, used to authenticate to ShipHero’s API. Note: In the ShipHero app, this is referred to as an API Key. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from ShipHero. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from ShipHero. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Shopify Source Form Property Object
Shopify connections read data from the Shopify API and correspond to source type: platform.shopify
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Shopify. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
shop
STRING REQUIRED |
The name of the Shopify shop. For example: If the shop URL was |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Shopify. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Stripe Source Form Property Object
Stripe connections read data from the Stripe API and correspond to source type: platform.stripe
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Stripe. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Toggl Source Form Property Object
Toggl connections read data from the Toggl API and correspond to source type: platform.toggl
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_token
STRING REQUIRED |
The user’s Toggl API token. For more info and instructions on retrieving this credential, refer to our Toggl setup documentation. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
detailed_report_trailing_days
STRING REQUIRED |
The number of days Stitch should replicate time entry data for during each replication job. This is only applicable to the For example: If this value is |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Toggl. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Toggl. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Typeform Source Form Property Object
Typeform connections read data from the Typeform API and correspond to source type: platform.typeform
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
forms
STRING REQUIRED |
The Typeform form ID(s) the user wants Stitch to replicate. If replicating multiple forms, enter the IDs as a comma-separated list. For example: |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Typeform. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
incremental_range
STRING REQUIRED |
The type of data aggregation Stitch should use when replicating Typeform data. Accepted values are:
|
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Typeform. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
token
STRING REQUIRED |
The user’s Typeform API token. Refer to our Typeform documentation for instructions on generating the token. |
Example Object
The UserVoice Source Form Property Object
UserVoice connections read data from the UserVoice API and correspond to source type: platform.uservoice
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The UserVoice API key. API keys must be generated by a user who can access Settings in their UserVoice account. Refer to UserVoice’s documentation for credential generation instructions. |
api_secret
STRING REQUIRED |
The UserVoice API secret. API secrets must be generated by a user who can access Settings in their UserVoice account. Refer to UserVoice’s documentation for credential generation instructions. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from UserVoice. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from UserVoice. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
subdomain
STRING REQUIRED |
The subdomain of the UserVoice account to replicate data from. For example: If the full subdomain were |
Example Object
The Xero Source Form Property Object
Xero connections read data from the Xero API and correspond to source type: platform.xero
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Xero. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
Example Object
The Yotpo Source Form Property Object
Yotpo connections read data from the Yotpo API and correspond to source type: platform.yotpo
.
Note: Creating a Yotpo source requires Yotpo API credentials. Retrieving these credentials requires Yotpo Account Administrator permissions. Refer to Yotpo’s documentation for more info.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
api_key
STRING REQUIRED |
The API Key for the Yotpo account Stitch should replicate data from. This is the App Key field in the Yotpo app, accessed by clicking User menu (people icon) > Account Settings > Store tab. |
api_secret
STRING REQUIRED |
The API Secret for the Yotpo account Stitch should replicate data from. This is the Secret Key field in the Yotpo app, accessed by clicking User menu (people icon) > Account Settings > Store tab. Note: Yotpo Account Administrator permissions are required to retrieve this information. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Yotpo. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Yotpo. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
Example Object
The Zendesk Source Form Property Object
Zendesk connections read data from the Zendesk API and correspond to source type: platform.zendesk
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Zendesk. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Zendesk. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
subdomain
STRING REQUIRED |
The prefix of the Zendesk subdomain Stitch should replicate data from. For example: If the address is |
Example Object
The Zuora Source Form Property Object
Zuora connections read data from the Zuora API and correspond to source type: platform.zuora
.
Note: Attributes marked as REQUIRED must be provided before the source can be considered fully_configured
.
anchor_time
STRING OPTIONAL |
Defines the time that This field must contain an ISO 8601-compliant date. Note: When Stitch stores this value, it will be in UTC. You should provide this value in UTC to ensure the desired anchor time is retained. For example: You want to create a schedule that is anchored to Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
cron_expression
STRING OPTIONAL |
Note: Advanced Scheduling using Cron is not yet supported for this source. A value may be submitted for this property if the account is on an Enterprise plan, but Stitch will not use the expression submitted. A valid Quartz cron expression representing the replication schedule for the integration. Refer to the Advanced Scheduling documentation for more info. Note: If neither a Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
european
STRING OPTIONAL |
If |
frequency_in_minutes
STRING REQUIRED |
Defines how often, in minutes, Stitch should attempt to replicate data from Zuora. Accepted values are:
Refer to the Replication Scheduling for API sources guide for more info about replication scheduling using the API. |
password
STRING REQUIRED |
The password associated with the Zuora user authorizing the connection. |
sandbox
STRING OPTIONAL |
If |
start_date
STRING REQUIRED |
The date from which Stitch should begin replicating data from Zuora. Data from this date forward will be replicated. This field must contain an ISO 8601-compliant date, and the timestamp must be midnight. For example: |
username
STRING REQUIRED |
The username of the Zuora user authorizing the connection. To successfully create a connection, this user must:
For more info, refer to our Zuora integration documentation. |