Skip to content
API Reference

API Introduction

Base URL

The base URL for Plunk's API is


Every request to Plunk's API needs to be authenticated with the public or secret key associated with your project. You can find these keys in the API settings of your project.


Only use your secret key in a secure, backend environment. Never expose your secret key to the public. In case you do, regenerate your secret key immediately.

Once you have your key, you can authenticate your requests by passing it as a Bearer token in the Authorization header.

await fetch('', {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": "Bearer API_KEY", // Put your API key here
    body: JSON.stringify({
        "event": "new-project",
        "email": "",

Response Codes

Plunk's API uses conventional HTTP response codes to indicate the success or failure of an API request.

Status CodeDescription
200The request was successful.
400The request was invalid. Your request body is likely missing a required field.
401The request was unauthorized. Your API key is invalid or not properly formatted.
402You have hit your plan's monthly limit. Upgrade, wait until next month, or contact us if your project is on an enterprise plan.
Last updated on May 2, 2023