GET /v1/connectors/54fa0b38a7044f9252000036 HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample Response:

{
    "_id":"54fa0b38a7044f9252000036",
    "name":"Shopify - NetSuite Connector",
    "description":"Shopify - NetSuite Connector helps retailers combine the powerful Shopify eCommerce platform with the proven back-office features of NetSuite and keep the orders, customers, fulfillments, billings, items & inventory levels in sync.",
    "imageURL":"/images/company-logos/shopify-netsuite.png",
    "websiteURL":"http://www.celigo.com/products/netsuite-shopify-connector/",
    "contactEmail":"sales@celigo.com",
    "handle":"sc4n",
    "published":true,
    "managed":true,
    "_integrationId":"551c7be9accca83b3e00000c",
    "_stackId":"5593228187085d362c000009",
    "installerFunction":"installConnector",
    "updateFunction":"updateConnector",
    "preUninstallFunction":"preUninstallFunction",
    "uninstallerFunction":"uninstallConnector",
    "externalInstallerFunction":"installConnectorFromExternalApp",
    "lastModified":"2017-09-12T11:47:25.957Z",
    "_sharedImportIds":[

    ],
    "_sharedExportIds":[

    ],
    "_iClientIdMap":[
        {
            "_id":false,
            "_iClientIds":[
                "58f9dfc4a7d2ca3238e19c89"
            ],
            "connection":{
                "type":"netsuite"
            }
        }
    ],
    "applications":[
        "netsuite",
        "shopify"
    ],
    "oAuthServerFlow":{
        "_iClientId":"54fa0c93a7044f9252000038"
    }
}

GET /v1/connectors/54fa0b38a7044f9252000036/licenses HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample Response:

[
    {
        "_id":"59ef03a31ce1f53606837667",
        "expires":"2018-11-16T18:29:59.999Z",
        "created":"2017-10-24T09:10:59.408Z",
        "opts":{
            "addonLicenses":[
                {
                    "licenses":[
                        {
                            "addOnEdition":"standard"
                        }
                    ],
                    "type":"store"
                }
            ],
            "connectorEdition":"standard"
        },
        "user":{
            "email":"Jane.Doe@celigo.com",
            "_id":"585222eb73409e646b7375ed",
            "name":"John Doe"
        },
        "_integrationId":"59ef03c4b62d305b3c4534d5"
    },
    {
        "_id":"59dc541a93d54c44a7840220",
        "expires":"2025-07-01T00:00:00.000Z",
        "created":"2017-10-10T05:01:14.178Z",
        "opts":{
            "addonLicenses":[
                {
                    "licenses":[
                        {
                            "addOnEdition":"enterprise"
                        }
                    ],
                    "type":"store"
                }
            ],
            "connectorEdition":"enterprise"
        },
        "user":{
            "email":"John.Doe@celigo.com"
        }
    }
]

Important: The API to create a new license (versus update an existing license) is unique in that you need to supply the email address of the integrator.io user in the post body, and then the integrator.io backend will use the email to dynamically find the correct user. Assuming the email is a valid user, you will see a read-only "user" property in the response, and then once the user clicks the install button from within their integrator.io account you will then see their "_id" and "name" values as well if you do another GET on the license resource (or just view it in your integrator.io account UI).

POST /v1/connectors/54fa0b38a7044f9252000036/licenses HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

{
    "email":"test@celigo.com",
    "expires":"2017-11-01T18:29:59.999Z",
    "opts":{
        "addonLicenses":[
            {
                "licenses":[
                    {
                        "addOnEdition":"standard"
                    }
                ],
                "type":"store"
            }
        ],
        "connectorEdition":"standard"
    }
}

Sample Response:

{
    "_id":"59ef68b384b38c7986d54549",
    "expires":"2017-11-01T18:29:59.999Z",
    "created":"2017-10-24T16:22:11.448Z",
    "opts":{
        "connectorEdition":"standard",
        "addonLicenses":[
            {
                "type":"store",
                "licenses":[
                    {
                        "addOnEdition":"standard"
                    }
                ]
            }
        ]
    },
    "user":{
        "email":"test@celigo.com"
    }
}

Note: Unlike the API to create new licenses (detailed above), you do NOT need to send "email" to update existing license records.

PUT /v1/connectors/54fa0b38a7044f9252000036/licenses/59ef68b384b38c7986d54549 HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

{
    "expires":"2020-11-01T18:29:59.999Z",
    "opts":{
        "addonLicenses":[
            {
                "licenses":[
                    {
                        "addOnEdition":"enterprise"
                    }
                ],
                "type":"store"
            }
        ],
        "connectorEdition":"enterprise"
    }
}

Sample Response:

{
    "_id":"59ef68b384b38c7986d54549",
    "expires":"2020-11-01T18:29:59.999Z",
    "created":"2017-10-24T16:22:11.448Z",
    "opts":{
        "connectorEdition":"enterprise",
        "addonLicenses":[
            {
                "type":"store",
                "licenses":[
                    {
                        "addOnEdition":"enterprise"
                    }
                ]
            }
        ]
    },
    "user":{
        "email":"test@celigo.com",
        "_id":"585222eb73409e646b7375ff",
        "name":"Celigo Tester"
    },
    "_integrationId":"59ef03c4b62d305b3c45f4ee"
}

POST /v1/connectors/54fa0b38a7044f9252000036/licenses HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

{
    "email":"does_not_exist@celigo.com",
    "expires":"2017-11-01T18:29:59.999Z",
    "opts":{
        "addonLicenses":[
            {
                "licenses":[
                    {
                        "addOnEdition":"standard"
                    }
                ],
                "type":"store"
            }
        ],
        "connectorEdition":"standard"
    }
}

Sample Response:

{
    "errors":[
        {
            "code":"invalid_user",
            "message":"We were not able to find any user with the provided email address. Please ask the user to first create an integrator.io account."
        }
    ]
}

GET /v1/template HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample Response:

[
    {
        "_id":"58f109e8927af74d60801fff",
        "name":"Send GitHub Notifications to Slack",
        "description":"This is a very simple integration that listens for commit events in GitHub, and then posts messages to Slack so that people can use Slack to monitor developer activity. The benefit of using this integration vs the free integration provided by Slack is that you can customize how the messages post to Slack. For example, you might want messages to post as if they were sent by the user that triggered the event in GitHub (vs a generic bot type user).",
        "imageURL":"https://secure.gravatar.com/avatar/33895cc016e520a2a07131c3753d8d4f?d=mm&s=55",
        "websiteURL":"http://www.celigo.com/",
        "contactEmail":"template@celigo.com",
        "published":true,
        "lastModified":"2017-04-24T16:54:25.186Z",
        "applications":[
            "github",
            "slack"
        ]
    },
    {
        "_id":"58f10e49927af74d608022ac",
        "name":"Send Travis Build Notifications to Slack",
        "description":"This integration listens for build notifications in Travis CI and posts messages to Slack. Very similar to the native integration that Slack has in their integration marketplace, except now you can completely customize how the messages appear in Slack. For example, you might want to minimize the message content that gets sent to Slack to only show the repository, user, and build status.",
        "imageURL":"https://secure.gravatar.com/avatar/33895cc016e520a2a07131c3753d8d4f?d=mm&s=55",
        "websiteURL":"http://www.celigo.com/",
        "contactEmail":"template@celigo.com",
        "published":true,
        "lastModified":"2017-04-24T16:57:55.663Z",
        "applications":[
            "slack",
            "travis"
        ]
    },
    {
        "_id":"58f12659c468a47a9489242c",
        "name":"Send Zendesk Tickets to Slack",
        "description":"This integration routes Zendesk tickets into Slack. This integration is used by Celigo's engineering and QA department to keep an eye on all support tickets being logged throughout the day (i.e. without having to login to Zendesk).",
        "imageURL":"https://secure.gravatar.com/avatar/33895cc016e520a2a07131c3753d8d4f?d=mm&s=55",
        "websiteURL":"http://www.celigo.com/",
        "contactEmail":"template@celigo.com",
        "published":true,
        "lastModified":"2017-04-24T16:58:00.199Z",
        "applications":[
            "slack",
            "zendesk"
        ]
    }
]

PUT /v1/template/58f12659c468a47a9489242c HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

{
    "name":"Give your template a really great name!",
    "description":"A good description helps a lot too.",
    "imageURL":"https://secure.gravatar.com/avatar/33895cc016e520a2a07131c3753d8d4f?d=mm&s=55",
    "websiteURL":"http://www.celigo.com/",
    "contactEmail":"template@celigo.com",
    "published":true,
    "applications":[
        "slack",
        "zendesk"
    ]
}

Sample Response:

{
    "_id":"58f12659c468a47a9489242c",
    "name":"Give your template a really great name!",
    "description":"A good description helps a lot too.",
    "imageURL":"https://secure.gravatar.com/avatar/33895cc016e520a2a07131c3753d8d4f?d=mm&s=55",
    "websiteURL":"http://www.celigo.com/",
    "contactEmail":"template@celigo.com",
    "published":true,
    "lastModified":"2017-10-24T15:03:45.140Z",
    "applications":[
        "slack",
        "zendesk"
    ]
}

GET /v1/jobs?type=import&status=running HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample Response:

[
    {
        "_id":"59ee8f9503785d04d846a88e",
        "type":"import",
        "_importId":"537d1ff57ab1870200000002",
        "_flowJobId":"59ee8f80e41d93365ef1b9a9",
        "startedAt":"2017-10-24T00:55:49.128Z",
        "status":"running",
        "numError":0,
        "numSuccess":1,
        "numIgnore":0,
        "numPagesProcessed":1,
        "oIndex":1,
        "retriable":false,
        "createdAt":"2017-10-24T00:55:49.128Z",
        "lastModified":"2017-10-24T00:55:49.642Z"
    }
]

GET /v1/jobs/59ee8cad03785d04d8469918/jobErrors HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample Response:

[
    {
        "resolve":false,
        "retry":false,
        "createdAt":"2017-10-24T00:43:30.434Z",
        "code":"422",
        "extract":"",
        "generate":"",
        "extracted":"",
        "generated":"",
        "message":"'{\"errors\":[{\"field\":\"expires\",\"code\":\"missing_required_field\"}]}'",
        "source":"integrator.io",
        "exportDataURI":"",
        "importDataURI":"",
        "_retryId":"59ee8cb203785d04d8469919",
        "_jobId":"59ee8cad03785d04d8469918"
    }
]