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"
}
]
}
}' \
--compressedconst 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"
}
}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.
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"
}
]
}
}' \
--compressedconst 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
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
Account slug of the user
Project slug of the account
Body
Request body for creating a simulation draft.
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
Show child attributes
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.
false
Response
The draft was stored.
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}.
"3f2a6c1e-8f1b-4c8e-9a2d-6b1e0f7c4d21"