API Authentication
Worky API uses OAuth 2.0 Bearer tokens for authentication. All API requests must include a valid access token in the Authorization header.
Getting Your API Token
Contact your Worky administrator to obtain API credentials. You'll receive:
- Client ID
- Client Secret
- API Scopes based on your access level
Making Authenticated Requests
Include the Bearer token in the Authorization header for all API requests:
Example authenticated request
curl -X GET "https://api-nova-dev.worky.mx/accounts/directory/api/v1/employees" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6..." \
-H "Content-Type: application/json" \
-H "Accept: application/json"Required Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer <token> | ✅ Yes |
Content-Type | application/json | ✅ Yes |
Accept | application/json | Recommended |
Token Expiration
Important: Access tokens expire after a set period. Implement token refresh logic in your application to maintain continuous access.