Skip to main content
POST
/
v1
/
gate
/
login-sessions
Create a Gate dashboard login session
curl --request POST \
  --url https://api.usefoil.com/v1/gate/login-sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_id": "gsvc_0123456789abcdefghjkmnpqrs"
}
'
{
  "data": {
    "object": "gate_login_session",
    "id": "gate_0123456789abcdefghjkmnpqrs",
    "status": "pending",
    "consent_url": "https://app.acme.co/signup",
    "expires_at": "2026-03-24T20:00:05.000Z"
  },
  "meta": {
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1"
  }
}

Authorizations

​
Authorization
string
header
required

Send Authorization: Bearer . Gate business endpoints require sk_* secret keys. Gate workflow endpoints use gate-native bearer tokens such as gtpoll_* or agt_* where documented.

Body

application/json
​
service_id
string
required

Canonical Gate service slug used by the public registry and by npx signup . Lowercase letters, numbers, dashes, and underscores only; must start and end with a letter or number.

Required string length: 3 - 32
Pattern: ^[a-z0-9](?:[a-z0-9_-]{1,30}[a-z0-9])$
Example:

"gsvc_0123456789abcdefghjkmnpqrs"

Response

Gate login session created.

​
data
object
required
Example:
{
  "object": "gate_login_session",
  "id": "gate_0123456789abcdefghjkmnpqrs",
  "status": "pending",
  "consent_url": "https://app.acme.co/signup",
  "expires_at": "2026-03-24T20:00:05.000Z"
}
​
meta
object
required
Example:
{
  "request_id": "req_cf147349a4134208aebb8c70e25fb7e1"
}