operation post api v1 contractors parameter login link.md
Generate login link
POST /api/v1/contractors/{contractor}/login_link
Generates a secure, time-limited login URL for contractor portal access. This allows agencies to provide direct portal access without requiring contractors to go through email verification.
Servers
- Production server: https://api.1099policy.com (Production server)
Parameters
Path parameters
- contractor (string)
The contractor's public ID
Body: application/json (object)
- redirect_url (string)
URL to redirect the contractor to after successful authentication. Must match an allowlisted origin.
Responses
200
Login link generated successfully
Body: application/json (object)
contractor (object)
expires_at (integer(int64))
Time at which the login token expires. Measured in seconds since the Unix epoch.login_url (string)
Complete login URL with embedded tokensuccess (boolean)
400
Contractor has no email address, or the supplied redirect_url is not an allowlisted origin.
404
Contractor not found
500
Failed to generate login link