Connecting integrations

All integrations supported by Composable Talent are added the same way to your account. These integrations are just Apps and so are managed the same way as any other. Remember, you'll need Organization admin or IT Admin permissions to save these apps.

For most you will need at minimum an API key and in many cases you will also need an Access token. Let's take a look at the general use case for one of the integrations:

POST https://api.peoplelogic.dev/api/v1/app
Content-Type: application/json
Authorization: Bearer {{demoOrgToken}}

{
  "type": "pl:sync:betterworks",
  "internal": false,
  "name": "Acme Corp Betterworks",
  "externalId": "acme-betterworks",
  "secretData": {
    "apiKey": "{{betterWorksApiKey}}"
  }
}

The externalId and type combination must be unique and the specifics of what goes into secretData are dependent on each integration. We'll cover those in the next section!