diff --git a/src/api/public-api/index.md b/src/api/public-api/index.md index b95c6d6b36..776bf62ef7 100644 --- a/src/api/public-api/index.md +++ b/src/api/public-api/index.md @@ -30,6 +30,20 @@ The Public API includes the following benefits over the Config API: | Available in Europe | The Public API is accessible to both US and EU-based workspaces. | | | Increased reliability | The Public API features more stable endpoints, and a 99.8% success rate | +## Create a Public API token + +> info "Only Workspace Owners can create a Public API token" +> Only users with the Workspace Owner role can create a Public API token. For more information about roles, see Segment's [Roles](/docs/segment-app/iam/roles/) documentation. + +To create a Public API token in your Segment workspace: +1. Navigate to Settings > Workspace settings > Access Management > Tokens. +2. Click the **+ Create Token** button. +3. Create a description for the token and assign it either Workspace Owner or Workspace Member access. +4. Click **Create**. +5. Copy your workspace token somewhere secure and click **Done**. + +To begin sending requests to the Public API, make sure to include the Public API Token into your HTTP requests with the `Authorization` Header and configured with `Bearer Token` and the value of the newly generated Public API token. + ## API Token Security