Generate contractor portal 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.

Path parameters

  • contractor string Required

    The contractor's public ID

Responses

  • 200 application/json

    Login link generated successfully

    Hide response attributes Show response attributes object
    • contractor object
      Hide contractor attributes Show contractor attributes object
      • company_name string
      • email string
      • first_name string
      • id integer
      • last_name string
      • public_id string
      • username string
    • expires_at string(date-time)

      Token expiration timestamp (ISO 8601)

    • login_url string

      Complete login URL with embedded token

    • success boolean
  • 400

    Contractor has no email address

  • 404

    Contractor not found

  • 500

    Failed to generate login link

POST /api/v1/contractors/{contractor}/login_link 
curl \
 --request POST 'https://api.1099policy.com/api/v1/contractors/{contractor}/login_link'
Response examples (200) 
{
  "contractor": {
    "company_name": "string",
    "email": "string",
    "first_name": "string",
    "id": 42,
    "last_name": "string",
    "public_id": "string",
    "username": "string"
  },
  "expires_at": "2025-12-12T16:00:00Z",
  "login_url": "https://my.1099policy.com/quick-access?contractor_id=cn_abc123&token=xyz789",
  "success": true
}