POST accounts

Configure Google Flow Account

November 17, 2025 (September 16, 2026)

Request Headers
Request Body
Responses
Model
Examples
Try It

Configure your Google Flow account for API access using cookies from your authenticated Google account.

Each useapi.net subscription covers 3 Google Flow accounts, up to a hard limit of 50.

https://api.useapi.net/v1/google-flow/accounts

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data

API token is required, see Setup useapi.net for details.

Request Body

{
  "cookies": "Name\tValue\tDomain\tPath\tExpires\t..."
}

cookies is required. Cookies copied from Chrome DevTools in table format. See Setup Google Flow for detailed instructions on how to obtain these cookies.

Responses

200 OK

Existing account configuration updated successfully.

{
  "accountCookies": [
    {
      "name": "HSID",
      "value": "AYQ...(redacted)",
      "domain": ".google.com",
      "path": "/",
      "expires": "2027-11-10T12:00:00.000Z",
      "httpOnly": true,
      "secure": false,
      "sameSite": "Lax"
    }
  ],
  "sessionCookies": [
    {
      "name": "__Host-GAPS",
      "value": "1:eJy...(redacted)",
      "domain": "labs.google",
      "path": "/",
      "expires": "2025-12-10T12:00:00.000Z",
      "httpOnly": true,
      "secure": true,
      "sameSite": "Lax"
    }
  ],
  "sessionData": {
    "user": {
      "name": "John Doe",
      "email": "jo***@gmail.com",
      "image": "https://lh3.googleusercontent.com/a/..."
    },
    "expires": "2025-11-11T12:00:00.000Z",
    "access_token": "ya29.a0A...(redacted)"
  },
  "created": "2025-11-10T12:00:00.000Z",
  "project": {
    "projectId": "3b1c0e9d-7a6f-4592-8d38-7f9e1b4c6a5d",
    "projectTitle": "Nov 11 - 02:56"
  },
  "nextRefresh": {
    "messageId": "msg-abc123",
    "scheduledFor": "2025-11-11T11:00:00.000Z"
  }
}

201 Created

New account configuration created successfully.

{
  "accountCookies": [
    {
      "name": "HSID",
      "value": "AYQ...(redacted)",
      "domain": ".google.com",
      "path": "/",
      "expires": "2027-11-10T12:00:00.000Z",
      "httpOnly": true,
      "secure": false,
      "sameSite": "Lax"
    }
  ],
  "sessionCookies": [
    {
      "name": "__Host-GAPS",
      "value": "1:eJy...(redacted)",
      "domain": "labs.google",
      "path": "/",
      "expires": "2025-12-10T12:00:00.000Z",
      "httpOnly": true,
      "secure": true,
      "sameSite": "Lax"
    }
  ],
  "sessionData": {
    "user": {
      "name": "John Doe",
      "email": "jo***@gmail.com",
      "image": "https://lh3.googleusercontent.com/a/..."
    },
    "expires": "2025-11-11T12:00:00.000Z",
    "access_token": "ya29.a0A...(redacted)"
  },
  "created": "2025-11-10T12:00:00.000Z",
  "project": {
    "projectId": "3b1c0e9d-7a6f-4592-8d38-7f9e1b4c6a5d",
    "projectTitle": "Nov 11 - 02:56"
  },
  "nextRefresh": {
    "messageId": "msg-abc123",
    "scheduledFor": "2025-11-11T11:00:00.000Z"
  }
}

400 Bad Request

Validation error (missing/invalid parameters or cookies).
```
{
  "error": "Failed to validate cookies: 401 Unauthorized"
}
```

404 — update mode: no account is configured for the given email.

{ "error": "Account user@email.com not found", "code": 404 }

401 Unauthorized

Invalid API token.
```
{
  "error": "Unauthorized"
}
```

402 Payment Required

Subscription expired or insufficient credits.

{
  "error": "Account has no subscription or subscription expired"
}

Model

created - ISO 8601 timestamp when the account was first configured, kept unchanged when you add the same account again
updated - ISO 8601 timestamp of the most recent add, so you can tell when an account was last refreshed
accountCookies - Google account cookies
sessionCookies - Session cookies for Google Flow
sessionData - User session information with access token
project - Google Flow project for this account, created on the first add and kept when you add the account again
nextRefresh - Scheduled refresh details (refreshes automatically 1 hour before expiry)

{ // TypeScript, all fields are optional
  backend: 'flow' | 'labs'     // which Google backend this account uses
  created: string              // ISO 8601 timestamp, first add
  updated: string              // ISO 8601 timestamp, most recent add
  accountCookies: Array<{
    name: string
    value: string              
    domain: string
    path: string
    expires: string | number
    httpOnly: boolean
    secure: boolean
    sameSite: 'Lax' | 'Strict' | 'None'
  }>
  sessionCookies: Array<{     
    name: string
    value: string             
    domain: string
    path: string
    expires: string | number
    httpOnly: boolean
    secure: boolean
    sameSite: 'Lax' | 'Strict' | 'None'
  }>
  sessionData: {
    user: {
      name: string
      email: string
      image: string
    }
    expires: string            // ISO 8601 timestamp
    access_token: string       
  }
  project: {
    projectId: string
    projectTitle: string
  }
  nextRefresh: {
    messageId: string
    scheduledFor: string       // ISO 8601 timestamp
  }
  health?: string              // "OK" | "Error information"
  error?: string               // Error message 
}

Examples

curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -X POST "https://api.useapi.net/v1/google-flow/accounts" \
     -d '{
       "cookies": "HSID\tAYQ...\t.google.com\t/\t2027-11-10...\nSSID\tAbc...\t.google.com\t/\t2027-11-10..."
     }'

import requests

apiUrl = 'https://api.useapi.net/v1/google-flow/accounts'
token = 'YOUR_API_TOKEN'
cookies = """HSID\tAYQ...\t.google.com\t/\t2027-11-10...
SSID\tAbc...\t.google.com\t/\t2027-11-10..."""

headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {token}'
}

body = {
    'cookies': cookies
}

response = requests.post(apiUrl, headers=headers, json=body)
print(response.status_code, response.json())

const apiUrl = 'https://api.useapi.net/v1/google-flow/accounts';
const token = 'YOUR_API_TOKEN';
const cookies = `HSID\tAYQ...\t.google.com\t/\t2027-11-10...
SSID\tAbc...\t.google.com\t/\t2027-11-10...`;

const response = await fetch(apiUrl, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cookies: cookies
  })
});

const result = await response.json();
console.log('Account configured:', result);

Try It

See Setup Google Flow page.