cURL

curl 'https://api.tenderly.co/api/v2/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulation-drafts' \
  -X 'POST' \
  -H 'X-Access-Key: ${TENDERLY_ACCESS_KEY}' \
  -H 'content-type: application/json' \
  --data-raw '{
    "payload": {
      "v": 2,
      "network": { "id": "1" },
      "rows": [
        {
          "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
          "inputDataType": "raw",
          "rawFunctionInput": "0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240"
        }
      ]
    }
  }' \
  --compressed

const options = {
  method: 'POST',
  headers: {'X-Access-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    payload: {
      v: 2,
      network: {id: '1'},
      rows: [
        {
          contractAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
          from: '0xab5801a7d398351b8be11c439e05c5b3259aec9b',
          inputDataType: 'raw',
          rawFunctionInput: '0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240'
        }
      ]
    }
  })
};

fetch('https://api.tenderly.co/api/v2/account/{accountSlug}/project/{projectSlug}/simulation-drafts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.tenderly.co/api/v2/account/{accountSlug}/project/{projectSlug}/simulation-drafts"

payload = { "payload": {
        "v": 2,
        "network": { "id": "1" },
        "rows": [
            {
                "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
                "inputDataType": "raw",
                "rawFunctionInput": "0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240"
            }
        ]
    } }
headers = {
    "X-Access-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tenderly.co/api/v2/account/{accountSlug}/project/{projectSlug}/simulation-drafts"

	payload := strings.NewReader("{\n  \"payload\": {\n    \"v\": 2,\n    \"network\": {\n      \"id\": \"1\"\n    },\n    \"rows\": [\n      {\n        \"contractAddress\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n        \"from\": \"0xab5801a7d398351b8be11c439e05c5b3259aec9b\",\n        \"inputDataType\": \"raw\",\n        \"rawFunctionInput\": \"0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240\"\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Access-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "resource_id": "3f2a6c1e-8f1b-4c8e-9a2d-6b1e0f7c4d21"
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "bad_request",
    "message": "Bad request input parameters"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "unauthorized",
    "message": "Unauthorized"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "insufficient_permissions",
    "message": "Insufficient permissions"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "resource_not_found",
    "message": "The resource you requested could not be found."
  }
}

{
  "error": {
    "id": "9a7bbe06-7f6f-4a45-8c78-8d64b9a9d0e1",
    "slug": "too_many_requests",
    "message": "API Rate limit exceeded."
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "internal_server_error",
    "message": "Internal server error"
  }
}

Simulator

Create a simulation draft

Store a Simulator setup (one call or a multi-call bundle, including state overrides, funded balances, and edited contract source) as a draft and receive an ID for a shareable link. Opening the link only prefills the Simulator form; nothing runs until the recipient clicks Simulate.

Put the returned resource_id in a dashboard link:

https://dashboard.tenderly.co/simulator/new?draftId={resource_id}

Visibility

shared: false (default): the draft is scoped to the project in the URL. Only members of that project can open it, and the dashboard redirects them straight into the project’s Simulator.
shared: true: any signed-in Tenderly user can open the draft in a project of their choice (the dashboard shows a project picker first). Use it for links aimed outside your organization, for example a governance UI that prefills a proposal simulation.

Payload handling

The payload is stored as received. The API enforces only the 256 KB size limit; the payload structure is validated when the draft opens in the dashboard, and a malformed payload is rejected there with an empty form. The dashboard itself creates drafts through this endpoint with shared: false.

Drafts expire automatically. Learn more about Simulator draft links.

POST

account

{accountSlug}

project

{projectSlug}

simulation-drafts

cURL

curl 'https://api.tenderly.co/api/v2/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulation-drafts' \
  -X 'POST' \
  -H 'X-Access-Key: ${TENDERLY_ACCESS_KEY}' \
  -H 'content-type: application/json' \
  --data-raw '{
    "payload": {
      "v": 2,
      "network": { "id": "1" },
      "rows": [
        {
          "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
          "inputDataType": "raw",
          "rawFunctionInput": "0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240"
        }
      ]
    }
  }' \
  --compressed

const options = {
  method: 'POST',
  headers: {'X-Access-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    payload: {
      v: 2,
      network: {id: '1'},
      rows: [
        {
          contractAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
          from: '0xab5801a7d398351b8be11c439e05c5b3259aec9b',
          inputDataType: 'raw',
          rawFunctionInput: '0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240'
        }
      ]
    }
  })
};

fetch('https://api.tenderly.co/api/v2/account/{accountSlug}/project/{projectSlug}/simulation-drafts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.tenderly.co/api/v2/account/{accountSlug}/project/{projectSlug}/simulation-drafts"

payload = { "payload": {
        "v": 2,
        "network": { "id": "1" },
        "rows": [
            {
                "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
                "inputDataType": "raw",
                "rawFunctionInput": "0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240"
            }
        ]
    } }
headers = {
    "X-Access-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tenderly.co/api/v2/account/{accountSlug}/project/{projectSlug}/simulation-drafts"

	payload := strings.NewReader("{\n  \"payload\": {\n    \"v\": 2,\n    \"network\": {\n      \"id\": \"1\"\n    },\n    \"rows\": [\n      {\n        \"contractAddress\": \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n        \"from\": \"0xab5801a7d398351b8be11c439e05c5b3259aec9b\",\n        \"inputDataType\": \"raw\",\n        \"rawFunctionInput\": \"0xa9059cbb000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b00000000000000000000000000000000000000000000000000000000000f4240\"\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Access-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "resource_id": "3f2a6c1e-8f1b-4c8e-9a2d-6b1e0f7c4d21"
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "bad_request",
    "message": "Bad request input parameters"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "unauthorized",
    "message": "Unauthorized"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "insufficient_permissions",
    "message": "Insufficient permissions"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "resource_not_found",
    "message": "The resource you requested could not be found."
  }
}

{
  "error": {
    "id": "9a7bbe06-7f6f-4a45-8c78-8d64b9a9d0e1",
    "slug": "too_many_requests",
    "message": "API Rate limit exceeded."
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "internal_server_error",
    "message": "Internal server error"
  }
}

Authorizations

X-Access-Key

string

header

required

An API key is a token that a client provides when making API calls. Send it as the X-Access-Key request header on any endpoint:

curl '<API_ENDPOINT>' \
  -H 'X-Access-Key: ${TENDERLY_ACCESS_KEY}' \
  ...

Learn how to generate API access tokens at Tenderly Docs.

Path Parameters

accountSlug

string

required

Account slug of the user

projectSlug

string

required

Project slug of the account

Body

application/json

Request body for creating a simulation draft.

payload

Simulation draft payload · object

required

A Simulator form snapshot. The API stores it as received; the dashboard validates it when the draft opens. A wrong v, an empty rows array, a non-string contractAddress, or a wrong-typed row field rejects the whole draft on open.

Show child attributes

shared

boolean

default:false

false (default) scopes the draft to the project in the URL: only its members can open it. true makes the draft openable by any signed-in Tenderly user in a project of their choice.

Example:

false

Response

The draft was stored.

resource_id

string<uuid>

required

ID of the stored draft. Use it as the draftId query parameter of the dashboard link: https://dashboard.tenderly.co/simulator/new?draftId={resource_id}.

Example:

"3f2a6c1e-8f1b-4c8e-9a2d-6b1e0f7c4d21"

Simulator

Virtual Environments

Alerts

Actions

Delivery Channels

Contracts

Wallets

Other

Create a simulation draft

Authorizations

Path Parameters

Body

Response