---
title: "Generate Authorization Code"
method: POST
path: "/authenticate/partner/request-authcode"
tags: ["Magic Links"]
---

# Generate Authorization Code

`POST /authenticate/partner/request-authcode`

Generates an authorization code for a strategic partner customer user.

Extracts partner ID from the JWT token in the Authorization header,
looks up the platform user ID, and generates a short-lived auth code.

**Security considerations:**
- Requires valid Bearer token in Authorization header
- Auth code is short-lived (typically 60 seconds)
- Auth code can only be used once

**Authentication:**
- Requires Bearer token in Authorization header

## Headers

- `Authorization` object, required

## Request body

- UserServicePartnerRequestauthcodeBody
  - `customerUserId` string — The customer user ID for which to generate the auth code (UUID). Either this or (customerId+email+firstName+lastName) must be provided.
  - `customerId` string — The customer ID for auto-provisioning. Required if customerUserId is not provided.
  - `email` string, email — User email for auto-provisioning. Required if customerUserId is not provided.
  - `firstName` string — User first name for auto-provisioning. Required if customerUserId is not provided.
  - `lastName` string — User last name for auto-provisioning. Required if customerUserId is not provided.
  - `scope` 'ADMIN' | 'MANAGER' | 'PAYROLL_ADMIN' | 'BILLING_ADMIN' | 'HR_ADMIN' | 'IT_ADMIN' — User scope/role for access permissions

## Response `200`

Auth code generated successfully

- UserServiceInlineResponse2001
  - `auth_code` string, required — The generated authorization code
  - `expires_in` integer, required — Auth code expiration time in seconds
  - `customer_user_id` string — The customer user ID (UUID). Included when a user was auto-provisioned.

## Other responses

- `400` — Bad Request - Validation failed
- `401` — Invalid or missing authorization token
- `500` — Internal Server Error - Unexpected server error

---

[API](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api.md) · [All operations](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usemultiplier/multiplier-public-rest-api/revisions/59cd6443fdbf/schema)