Skip to main content
POST
Creates a direct connection for a user.
This endpoint requires a valid authorisation for the user. If no active authorisation exists, the request will be rejected. You can optionally pass the x-teal-authorisation-id header to specify which authorisation to use; otherwise the system will resolve a valid authorisation automatically. See Authorisations for more details.

Authorizations

X-API-KEY
string
header
required

Headers

x-teal-authorisation-id
string<uuid>

Optional authorisation ID to associate with this request. If not provided, the system will attempt to resolve a valid authorisation for the user automatically.

Example:

"7f3b8c2a-1d4e-4f6a-8b8c-9a0b1c2d3e4f"

Body

application/json
user_id
string
required

The id of the user

Example:

"95a0e70b-fe02-4f47-aef9-2efff279df71"

Response

Created

pagination
object
required
payroll_submissions
object[]
required