To authenticate to the Cobalt API, you need an access token.

To authenticate to the Cobalt API, you need an access token.


:::info
You can create multiple API tokens in the Cobalt UI. If needed, you can [revoke](https://docs.cobalt.io/en-us/articles/revoke-your-personal-cobalt-api-tokens-1QJ0vt4nzg) and regenerate tokens.

:::


1. Navigate to <https://app.cobalt.io/settings/api-tokens>. If needed, sign in to the Cobalt app.
2. Enter a name for your token.
3. Select **Generate New Token**.
4. In the modal that appears, you should see your API token, in the **Secret Token** field.

Save the token. After you close the overlay, you won’t see the full token again. If you lose it, you may have to [revoke](https://docs.cobalt.io/en-us/articles/revoke-your-personal-cobalt-api-tokens-1QJ0vt4nzg) the token and start over.

 ![](https://brainfish-storage-prod.s3-accelerate.amazonaws.com/uploads/8e42b09c-e27b-4b5a-ba0c-7a5ef138ea38/453ca266-39a5-473d-b77b-da8144a748c7/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAUPPN5IL32LSOV6HC%2F20260416%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260416T164143Z&X-Amz-Expires=3000&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEPX%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJHMEUCIQCMRurmZviCVwvT17BM7gkEhyGZQ%2FMoT%2F33d0xHhlqF0wIgadI%2By064W7PCAOHjRqrl3ImXuvmdjObeO7SD5olnhT8q5gUIvv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgwzMDgxMjU5NzUyODciDLqWN2FTB0IyZBn2oSq6BfiyCCTvAWLRn3PsvaDpTW7UKNbeIhJTLdA3fhdKIFNJnsDtWoyOgY5ip5SMhm2%2FKppX1xHrK3BN0agfpU5Ar%2Bn8HlkXVKkMuWmwVua3r9f3V7x2PH4A6dDQjcvY2rF2FGTDgP4HTkj15iobULx%2Bw288GdPnStICc8UYweB8YIOC9Tl%2FQorB%2F9bPZfs8Zmnsl3HRTuv4CJV21g9A7NGfp3AhyYkpgclZpNFl9F46JeQVQOdbbjShIbh8T1OuO%2BN2Z6niej6YshCUnArnRMteUXNVeDzAQen9BVsCG4pkEu41jdlCJmIrvyAF7KOTr6IW%2B4oAe%2BsQ4gpKGitQopz87Cp5dVYQfKzSdEhD2kQGvXvaFlBwJdhpYWhZgqMuipsl018j89Dp%2FkJW8fm33pKYyhj3AenPLh52PqEmABrq5iWU3cu6YqR%2Ff4E6qxGHyDJsL9BhiP1V6%2FU5%2BhTyBl4zZ4rZbGzeVWPAgNPEeD%2FjjDbAsTFREscA7ZyfdT6N0u0f%2FjL4Okk5QNx0qyiotiIrdWO4JvCrFCUIVA7USstXtsXO3l1qtefh1RfEVtLL%2FsAcutdT1%2Ftctk4Ht0qtBQsodYvVwqpVTkgU6iuJvF5Ups3rpLlpl%2BYuXOpgsnT3GlSPK6NsEWgYlAJsyDdLvrOMwOP9jEE9GZYmB1hLoUbnnYtPwTfb1nrJ%2FfFLrPjiblg3BIHywOuyXwWqsCr3fFZSgj8OFX26SfA8gTp4GYDZ%2FcPZ7LvHeaZfvhLLsf4IgyMDQsgxzD15rpkO2Y2wfTkepY2dfs%2F5f4DbboQbkuRppFnHlQ2nkHlE6zsSiJ2H7upxPbSgo5P4MoF1Rs6BijZYcM75Pz0jQHWl8XLlDS43CDaWHBfYJlJJ8mcuHiwYwh8WzdgsFDZmH9Nzqf1Vl8pvdlqlRDla0jE%2FxfSyMOK9g88GOpABvnV9JMTBiWwOmfx%2Bm%2FA7U9EcdJ7snKI%2B0g2rMxpXWkM5NVOOcYYxefyv5WfRWmPAIOxFtpuitbwVN34hXVX730qsaNLieoFlfQANGSKuzb8TVGBq4av%2F%2Fu1UcrqyJ5ulc2pIbYQUImFheI4HPpuL5xTEFWXf%2BXhP8FUT9uX1bCFvia1U8%2B398r4mOng6B9YP&X-Amz-Signature=c95a4365c48d10eaff74004a87a5e85fdd9cd4b0add210834a182200c57a4bcc&X-Amz-SignedHeaders=host&response-content-disposition=attachment)

Create a Personal Cobalt API Token

Errors

Cobalt API Overview

Introduction

Partner Integrations

API Versions

Credits

Events

Authentication

Assets

Subscription

EU Data Center

Organizations

Pentests

Findings

Engagements

Engagement Findings

Attack Surface

DAST Targets

DAST Scans

DAST Scheduled Scans

DAST Findings

External Ticket References

Tokens

Webhooks

Pagination

Idempotency

Rate Limits

Changelog

Get an Organization Token

Revoke Your Personal Cobalt API Tokens

Create or Modify an Asset

Import Findings to Google Sheets

Cobalt API

How to get started with Cobalt

Getting Started

Risk Advisories

Assets are what we pentest

Asset Types

Create an Asset

Overview

Asset Details

Pentest Details

Scope & Test Period

Preparation

Create a Pentest

Pentest Process

Pentest States

Coverage Checklist

Pentest Expectations

Set Up an In-House Pentest

Complete an In-House Pentest (For Pentesters)

In House Pentests

Severity Levels

Finding States

Remediate Findings

Customize Your Report

Co-branded Reports

Contents of a Pentest Report

Reports

Engagements Overview

Digital Risk Assessment

Secure Code Review

Insights

Planning

Cobalt Methodologies Overview

Web Methodologies

API Methodologies

External Network Methodologies

Internal Network Methodologies

Mobile Methodologies

Cloud Configuration Review Methodologies

Cloud Pentest Methodology

Desktop Methodologies

AI/LLM Methodologies

Digital Risk Assessment Methodology

Secure Code Review Methodologies

Methodologies

Attack Surface Monitoring (ASM)

DAST Scanner Overview

Best Practices

Integrations

Partial Scans: Reduced Scope

Scans

Sequence recorder

Targets

Target Authentication

Extra Hosts

Blackout Period

DAST Scanner

Account Overview

Account Settings

Password Best Practices

Sign In to Cobalt

Troubleshoot Sign-in Issues

User Account

Collaboration Overview

Collaborate on Pentests

Groups

Manage Pentest Collaborators

Manage Notifications

User Roles and Permissions

Collaboration

Organization Overview

Manage Users

Your Cobalt Contract

How to Configure SAML 2.0 for Cobalt 

SAML Migration: Update Your Configuration

Configure SAML SSO

SCIM Provisioning Setup Guide

Configure Organization Settings

Organization

Cobalt Credits

Track Your Credits

Cobalt PtaaS Tiers

Cobalt Integrations Overview

Connect your applications

Create GitHub tickets for Findings

Send MS Teams notifications for Findings

Create Azure DevOps Work Item for Findings

Create Jira tickets for Findings

Send email notifications for Findings from Outlook

Create GitLab tickets for Findings

HTTP Connector

Import Assets from Google Sheets

Map Cobalt Pentest Finding Severity to Jira Issue Priority

Modify Jira Issue Summary to contain Pentest Title

How to Guides

Troubleshooting

Integration Builder

Jira Data Center Integration

Push Cobalt Findings to Jira

Switching to a New Jira Instance

Jira Cloud Integration

Troubleshoot Your Jira Integration

Synchronize Cobalt Severity Levels with Jira

Integrate Jira with Cobalt

Slack

Microsoft Teams

DefectDojo

Kenna Security

Vanta

Carried Over Findings

Create Test Finding

Glossary

March 2026

February 2026

January 2026

November 2025 

August 2025

July 2025

June 2025

May 2025

April 2025

March 2025

January 2025

December 2024

November 2024

October 2024

September 2024

August 2024

July 2024

June 2024

May 2024

April 2024

March 2024

January 2024

What's New

Guide

Cobalt Product Documentation

Create a Personal Cobalt API Token

Share

Share

Create a Personal Cobalt API Token

Share

Share