Skip to main content

Connection Templates

Not availableCloud Not availableSelf-Managed CommunityNot availableSelf-Managed EnterpriseAvailableEmbedded Compare

A connection template pre-defines the Destination side of every pipeline your customers spin up through the Embedded widget. It answers two questions up-front:

  1. Where should the data land?
  2. How often should it sync?

When a customer finishes configuring a Source, Airbyte automatically creates the connection by combining their source settings with your template.

You'll need the following to create a connection template:

  • Your organization ID
  • The destination definition ID
  • The destination configuration
  • The destination name: We'll automatically create a destination with the given name in your user's workspaces
  • (optional) A cron expression describing when to run syncs. The cron expression must follow the Quartz syntax. You can use freeformatter.com to help validate the expression
info

S3 is the only destination we currently support for Airbyte Embedded.

Here is an example request for creating a connection template:

curl --request POST 'https://api.airbyte.ai/api/v1/integrations/connections/' \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <bearer_token>" -H 'Content-Type: application/json' \
  --data-raw '{
    "destination_name": "s3", 
    "cron_expression": "0 15 2 * * *",
    "organization_id": "<organization_id>",
    "destination_actor_definition_id": "4816b78f-1489-44c1-9060-4b19d5fa9362",
    "destination_config": {
      "access_key_id": "<aws_access_key>",
      "secret_access_key": "<aws_secret_key>",
      "s3_bucket_name": "<s3_bucket>",
      "s3_bucket_path": "<s3_prefix>",
      "s3_bucket_region": "<s3_region>",
      "format": {
        "format_type": "CSV",
        "compression": {
          "compression_type": "No Compression"
        },
        "flattening": "Root level flattening"
      }
    }
  }'

You can find the full connector specification in the Connector Registry.

You can find the reference docs for creating a connection template here.