UNuntools
Sources

Create source connection (zendesk / github)

Create a connection by pasting a personal API token. Use POST /ingestion/upload for file-based connections.

post/sources

Request

  • Base URL
    https://api.untools.co/api
  • Auth
    HTTP bearer

Request body

provider'zendesk' | 'github' required
labelstring
oauthPendingIdstring uuid nullable

When present, the access token is pulled from the pending OAuth session.

configobject

Provider-specific config. Zendesk: { subdomain } (also filled automatically from the pending OAuth session). GitHub: { owner, repo } (required — the repo the user picked).

credentialsobject

Manual token path only. Zendesk: { token: 'email/token:api_token' } (Basic auth). GitHub: { token: 'ghp_xxx' } (PAT). Not required when oauthPendingId is set.

Example request

{
  "provider": "github",
  "label": "Untools — main repo",
  "config": {
    "owner": "untools",
    "repo": "ainotetaker"
  },
  "credentials": {
    "token": "ghp_xxx"
  }
}

Response

Created

idstring uuid
provider'zendesk' | 'github' | 'upload'
labelstring
configobject
status'connected' | 'syncing' | 'error' | 'disconnected'
lastSyncAtstring date-time nullable
createdAtstring date-time
updatedAtstring date-time
itemCountinteger

Changes

No recorded changes to this operation across all 1 revision of this API.