Create/update HeyGen API account

July 4, 2025

Table of contents

  1. Request Headers
  2. Request Body
  3. Responses
  4. Model
  5. Examples
  6. Try It

This endpoint adds or updates a HeyGen account in your configuration. The API will automatically login to verify your credentials.

https://api.useapi.net/v1/heygen/accounts

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data
Request Body 
{
  "email": "[email protected]",
  "password": "your-password",
  "maxJobs": 10
}

  • email and password are required.
    Please see Setup HeyGen for details.

  • maxJobs is required, specify maximum number of concurrent jobs (1-10)

Responses

  • 201 Created

    {
  "email": "[email protected]",
  "session": {
    "heygen_session": "…secured…",
    "ExpireTime": 1720123456789,
    "ExpireTimeUTC": "2024-07-04T12:30:45.789Z",
    "access_token": "…secured…",
    "session_token": "…secured…",
    "space_id": "space_abc123",
    "token": "…secured…",
    "username": "[email protected]",
    "ack_agreement": true,
    "internal": false,
    "need_mfa": false
  },
  "maxJobs": 10,
  "password": "…secured…"
}

  • 400 Bad Request

    {
  "error": "Account does not exist or password is incorrect"
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 402 Payment Required

    {
  "error": "Subscription required",
  "code": 402
}
Model 
{ // TypeScript, all fields are optional
  email: string
  session: {
    heygen_session: string
    ExpireTime: number
    ExpireTimeUTC: string
    access_token: string
    session_token: string
    space_id: string
    token: string
    username: string
    ack_agreement: boolean
    internal: boolean
    need_mfa: boolean
  }
  maxJobs: number
  password: string
  error: string
}
Examples 
  • curl -X POST https://api.useapi.net/v1/heygen/accounts \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer …" \
   -d '{"email": "[email protected]", "password": "your-password", "maxJobs": 10}'

  • const token = "API token";
const apiUrl = "https://api.useapi.net/v1/heygen/accounts"; 
const response = await fetch(apiUrl, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${token}`,
  },
  body: JSON.stringify({
    email: "[email protected]",
    password: "your-password",
    maxJobs: 10
  })
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
apiUrl = "https://api.useapi.net/v1/heygen/accounts"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
data = {
    "email": "[email protected]",
    "password": "your-password",
    "maxJobs": 10
}
response = requests.post(apiUrl, headers=headers, json=data)
print(response, response.json())
Try It