Creates a new personal access token.

Usage Example

POST /api/v1/auth/tokens
Authorization: Bearer {existing_token_or_oauth_token}
Content-Type: application/json

{
  "name": "Local Development Token",
  "billingGroupId": 123
}

Response:

{
  "accessToken": "pat_1234567890abcdef1234567890abcdef",
  "expiresUtc": "2025-11-06T10:00:00Z"
}

⚠️ IMPORTANT: The accessToken is only returned once. Store it securely immediately.

Next Steps

Use the token in API requests:

GET /api/v1/network/contacts
Authorization: Bearer pat_1234567890abcdef1234567890abcdef

Body·CreatePersonalAccessTokenRequest

required

Token creation details

Request to create a new personal access token (PAT) for API authentication.

billingGroupId
Type: string Pattern: ^-?(?:0|[1-9]\d*)$Format: int32

Optional tenant ID to scope this token. If omitted, your primary tenant will be used.
name
Type: null | string
max length:
255

Optional friendly name for the token (e.g., "CI/CD Pipeline", "Local Development").

Responses

application/json
application/problem+json
application/problem+json
application/problem+json

post/api/v1/auth/tokens

curl https://app.propstreet.com/api/v1/auth/tokens \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": "Local Development Token",
  "billingGroupId": 123
}'

Show Schema

{
  "accessToken": "pat_1234567890abcdef1234567890abcdef",
  "expiresUtc": "2025-11-06T10:00:00Z"
}

Token created successfully