How to Create a New Connector Based on an Existing Connector's Parameters

You can create new connectors using the parameters of an existing connector. That is, you can clone a Fivetran connector.

1. Retrieve the connector object details using the Retrieve Connector Details endpoint.

   Requestlink

   GET https://api.fivetran.com/v1/connectors/{connector_id}

   Path parameterslink

   Name	Description
   connector_id (required)	The unique identifier for the connector within the Fivetran system.

   Responselink

   HTTP 200 OK

2. Make a note of the following fields from the API response:

   {
       "group_id": "projected_sickle",
       "service": "criteo",
       "config": {
           "username": "myuser",
           "password": "******",
           "api_token": "******",
           "service_version": "0"
       }
   }
   

3. Create the new connector using the fields from the previous step using the Create a connector endpoint.

   Requestlink

   POST https://api.fivetran.com/v1/connectors

   {
       "service": "criteo",
       "group_id": "projected_sickle",
       "trust_certificates": true,
       "run_setup_tests": true,
       "config": {
           "schema": "criteo",
           "username": "myuser",
           "password": "mypassword",
           "app_token": "myapptoken"
       }
   }
   

   Payload parameterslink

   Name	Description
   group_id (required)	The unique identifier for the group within the Fivetran system. Find you group_id by fetching your account’s group list.
   service (required)	The name for the connector type within the Fivetran system.
   config (required)	The connector setup configuration. The format is specific to each connector.
   trust_certificates	Specifies whether we should trust the certificate automatically. Applicable only for database connectors. The default value is FALSE. If a certificate is not trusted automatically, it has to be approved using the Certificates Management API.
   run_setup_tests	Specifies whether setup tests should be run automatically. The default value is TRUE.

   Responselink

   HTTP 201 Created