---
updatedAt: 2026-04-22T14:43:28.000Z
agentTools:
  projectIndex: https://docs.rocketreach.co/llms.txt
---

# Get a RocketReach API Account

Create New API Key

Use the RocketReach Account API to securely generate new API keys for your account. Your previous API key will immediately be invalidated. You may only have one API key active at a time.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "RocketReach API",
    "version": "1.0.0",
    "description": "The RocketReach API lets you search and retrieve contact info for 700M+ professionals and 35M\n    companies. Manage API settings, track usage, and find your API key on the account page.\n    All API calls require authentication via API key.\n    If you have any questions, please reach out to our team at api@rocketreach.co.\n    </br><span style=\"font-size:1.8rem; pass\">Quickstart</span>\n        1. Create an API key: Select “Generate New API Key” on your Account Settings page\n        2. Test API Key: You can test API endpoints directly in our documentation without writing a single line of code.\n            - Select an endpoint (GET /person/lookup for example)\n            - Select “Try It”\n            - Enter your API Key to send the request\n        3. Create Webhook (optional, but recommended): We offer a webhook solution for person lookups so clients do not need to poll the check status endpoint until their results are available.\n            - To set up a webhook, go to your API settings. Enter your server's callback URL into the field, and hit \"Create\".\n            - For each URL created, you can perform some basic maintenance tasks:\n                - Test the webhook - we will attempt to send a basic JSON payload to the URL.\n                - Disable/enable - if you may use this URL in the future, this is an option to temporarily disable it.\n                - Delete - if you no longer plan using this URL, it can be deleted.\n    </br><span style=\"font-size:1.8rem;pass\">Rate Limits</span>\n        - [Rate Limits](../guides/rate-limits.md)\n    </br><span style=\"font-size:1.8rem; pass\">FAQ</span>\n        - [FAQ](../guides/faq.md)\n    ",
    "contact": {
      "name": "RocketReach Support",
      "email": "api@rocketreach.co"
    }
  },
  "paths": {
    "/account/key/": {
      "post": {
        "operationId": "create_new_api_key",
        "description": "Create New API Key",
        "summary": "Get a RocketReach API Account",
        "tags": [
          "Account"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/APIKey"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/APIKey"
              }
            },
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/APIKey"
              }
            }
          },
          "required": true
        },
        "security": [
          {
            "RocketReachAPIKey": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIKey"
                }
              }
            },
            "description": "Success. Returns the new API key."
          },
          "400": {
            "description": "Bad Request. The request is malformed or missing required parameters."
          },
          "401": {
            "description": "Unauthorized. API Key is missing or invalid."
          },
          "403": {
            "description": "Forbidden. API Key lacks permission to perform this action."
          },
          "404": {
            "description": "Not Found. The requested resource (e.g., profile) does not exist."
          },
          "429": {
            "description": "Too Many Requests. API request limit reached -- slow down requests."
          },
          "500": {
            "description": "Internal Server Error. Unexpected error on RocketReach servers. Try again later."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "APIKey": {
        "type": "object",
        "properties": {
          "api_key": {
            "type": "string",
            "description": "The API key for your account. You can also find your API key [here](https://rocketreach.co/account?section=nav_gen_api)."
          }
        }
      }
    },
    "securitySchemes": {
      "RocketReachAPIKey": {
        "type": "apiKey",
        "name": "Api-Key",
        "in": "header",
        "description": "RocketReach account API key. You can locate your API Key from the \"My API Key\" section of the [API account page](https://rocketreach.co/account?section=nav_gen_api). Requests to the API are authenticated using the Api-Key request header. Older clients may use an `api_key` query parameter, but this behavior is deprecated."
      }
    }
  },
  "servers": [
    {
      "url": "https://api.rocketreach.co/api/v2",
      "description": "v2 Production Server"
    }
  ]
}
```