Create a portal access token

POST

https://api.gigstack.io/v2/teams/{id}/portal-access-token

Mint a short-lived, read-only access token for the team's public portal, and get a ready-to-share magic link.

The link opens the gigstack public portal (embeded.gigstack.pro) where the team can list and download its issued live-mode invoices, branded with your master team's logo and colors. The token cannot create, modify or cancel anything, and it only grants the scopes you request.

Important: Minting a token for a team other than your own is only available for gigstack Connect accounts (master teams), and the target team must belong to your billing account.

Use Cases

Embed an "invoices" section for your sub-teams inside your own product

Generate on-demand links so a sub-team can review its issued invoices without a gigstack login

Recommendations

Generate the link at click time and redirect the user to it; do not store it or send it by email

Use the default 1h expiry unless you have a longer-lived embedded session

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Portal access token created successfully

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.gigstack.io/v2/teams/team_1234567890/portal-access-token' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "expiresIn": "1h",
    "scopes": [
        "invoices:read"
    ]
}'

Response Example

200 - Example 1

{
    "token": "string",
    "url": "https://embeded.gigstack.pro/facturas?t=eyJhbGciOi...",
    "expiresAt": "2026-08-13T21:30:00.000Z"
}

Modified at 2026-08-14 03:51:40

Health check

Users API Guide

Create a portal access token

Use Cases#

Recommendations#

Request

Responses

Use Cases

Recommendations