Connector SDK
Represents a package for a custom connector built with the Fivetran Connector SDK.
Unlike standard connectors, Connector SDK connections require the following process:
- Create a package of your connector code locally using the
fivetran packagecommand. - Upload it using the package management endpoints.
- Use the standard Create a Connection endpoint with the returned
package_idin the configuration and credentials specified in thesecrets_listto create the connection.
Each package can only be associated with one connection at a time. If you need to use the same connector code for multiple connections, you must create separate packages.
Resource attributes
The following attributes describe a Connector SDK package.
| Field name | Type | Description |
|---|---|---|
id | string, read-only | Unique identifier of the package. |
created_at | string, read-only | Date and time the package was created, in ISO 8601 format. For example, "2025-01-14T19:30:00Z" |
created_by | string, read-only | Unique ID of the user who created the package. |
updated_at | string, read-only | Date and time the package was last updated, in ISO 8601 format. For example, "2025-01-14T19:30:00Z" |
last_updated_by | string, read-only | Unique ID of the user who last updated the package. |
connection_id | string, read-only | ID of the connection associated with the package. Null if no connection is associated. |
file_sha256_hash | string, read-only | SHA-256 hash of the package file, used for integrity verification. |
Supported operations
| Category | Endpoint | Description |
|---|---|---|
| List | GET /v1/connector-sdk/packages | Returns a paginated list of all Connector SDK packages in the Fivetran account. |
| Create | POST /v1/connector-sdk/packages | Uploads a new Connector SDK package. |
| Retrieve | GET /v1/connector-sdk/packages/{package_id} | Returns the details of a Connector SDK package. |
| Update | PATCH /v1/connector-sdk/packages/{package_id} | Updates an existing Connector SDK package. |
| Delete | DELETE /v1/connector-sdk/packages/{package_id} | Deletes a Connector SDK package. |
| Download | GET /v1/connector-sdk/packages/{package_id}/download | Downloads the Connector SDK package file. |