Postman – configuration example

Step 1: Obtain a Bearer token

Create a POST request to get the access token:


POST https://integrations-api.teamio.com/api/v1/auth/token

Set the Body to raw / JSON:


{
  "username": "<YOUR_CLIENT_ID>",
  "password": "<YOUR_CLIENT_SECRET_BASE64URL_ENCODED>"
}

Copy the accessToken value from the response.

In Postman, open the Authorization tab on your request or collection, select Bearer Token, and paste the accessToken value.

Create a new POST request:


POST https://integrations-api.teamio.com/api/v1/candidate-reactions

Set the Body to raw / JSON:

Field	Required	Description
firstName	yes	Candidate’s first name
surname	yes	Candidate’s last name
email	yes	Candidate’s email address
phone	no	Phone number
recruitmentId	yes	Teamio recruitment ID
attachments	no	Array with filename, content (base64), contentType, type
gdprNotice	yes	Object with optional `consentText` (attachment object) and optional `validTo` (ISO-8601 datetime for explicit consent)

Copy the returned requestUuid UUID from the response.

Create a new GET request using the UUID returned in Step 2:


GET https://integrations-api.teamio.com/api/v1/candidate-reactions/<requestUuid>

Repeat until status is COMPLETED or FAILED.

Store variables in a Postman Environment to switch easily between sandbox and production:

Variable	Description
`base_url`	`https://integrations-api.teamio.com`
`token`	Bearer token from Teamio UI (sandbox or production)
`recruitment_id`	The target recruitment ID

For sandbox validation without saving data, use:


POST https://integrations-api.teamio.com/api/v1/candidate-reactions/test

with your sandbox token and the same request body.