curl --request POST \
--url https://app.searchable.com/api/mcp/pitches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"brandName": "<string>",
"brandSummary": "<string>",
"country": "<string>",
"competitors": [
"<string>"
],
"generatePrompts": true,
"brandNameDisambiguation": "<string>",
"city": "<string>",
"state": "<string>",
"language": "<string>",
"brandAliases": [
"<string>"
],
"name": "<string>",
"dryRun": true
}
'import requests
url = "https://app.searchable.com/api/mcp/pitches"
payload = {
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"brandName": "<string>",
"brandSummary": "<string>",
"country": "<string>",
"competitors": ["<string>"],
"generatePrompts": True,
"brandNameDisambiguation": "<string>",
"city": "<string>",
"state": "<string>",
"language": "<string>",
"brandAliases": ["<string>"],
"name": "<string>",
"dryRun": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
domain: '<string>',
brandName: '<string>',
brandSummary: '<string>',
country: '<string>',
competitors: ['<string>'],
generatePrompts: true,
brandNameDisambiguation: '<string>',
city: '<string>',
state: '<string>',
language: '<string>',
brandAliases: ['<string>'],
name: '<string>',
dryRun: true
})
};
fetch('https://app.searchable.com/api/mcp/pitches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.searchable.com/api/mcp/pitches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'workspaceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'domain' => '<string>',
'brandName' => '<string>',
'brandSummary' => '<string>',
'country' => '<string>',
'competitors' => [
'<string>'
],
'generatePrompts' => true,
'brandNameDisambiguation' => '<string>',
'city' => '<string>',
'state' => '<string>',
'language' => '<string>',
'brandAliases' => [
'<string>'
],
'name' => '<string>',
'dryRun' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.searchable.com/api/mcp/pitches"
payload := strings.NewReader("{\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"<string>\",\n \"brandName\": \"<string>\",\n \"brandSummary\": \"<string>\",\n \"country\": \"<string>\",\n \"competitors\": [\n \"<string>\"\n ],\n \"generatePrompts\": true,\n \"brandNameDisambiguation\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"language\": \"<string>\",\n \"brandAliases\": [\n \"<string>\"\n ],\n \"name\": \"<string>\",\n \"dryRun\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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))
}HttpResponse<String> response = Unirest.post("https://app.searchable.com/api/mcp/pitches")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"<string>\",\n \"brandName\": \"<string>\",\n \"brandSummary\": \"<string>\",\n \"country\": \"<string>\",\n \"competitors\": [\n \"<string>\"\n ],\n \"generatePrompts\": true,\n \"brandNameDisambiguation\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"language\": \"<string>\",\n \"brandAliases\": [\n \"<string>\"\n ],\n \"name\": \"<string>\",\n \"dryRun\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.searchable.com/api/mcp/pitches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"<string>\",\n \"brandName\": \"<string>\",\n \"brandSummary\": \"<string>\",\n \"country\": \"<string>\",\n \"competitors\": [\n \"<string>\"\n ],\n \"generatePrompts\": true,\n \"brandNameDisambiguation\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"language\": \"<string>\",\n \"brandAliases\": [\n \"<string>\"\n ],\n \"name\": \"<string>\",\n \"dryRun\": true\n}"
response = http.request(request)
puts response.read_body{
"pitch": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "active",
"createdAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z",
"daysLeft": 123,
"extended": true,
"refreshes": {
"limit": 123,
"used": 123,
"remaining": 123
},
"hiddenFromPicker": true,
"trackedPromptCount": 123,
"canReactivate": true,
"canExtend": true
},
"success": true,
"promptGeneration": "started",
"location": {
"countryCode": "<string>",
"city": "<string>",
"region": "<string>",
"label": "<string>"
},
"notes": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}Create a pitch
Create a pitch: a 7-day trial project for a prospect, set up as the app’s Add project flow sets one up with the pitch option: the pitch, its competitors, brand profile, default location and onboarding record, with 5 manual refreshes and one 7-day extension. It takes the details POST /api/mcp/projects takes, without description (a pitch stores none). A pitch’s prompts count against the workspace’s pitch allowance, never the plan’s prompt allowance; generatePrompts: true starts the app’s prompt generation in the background, within it. dryRun: true runs every check and answers the preview with 200, creating nothing. Requires a connection minted with the project:provision capability (not the bare write scope); a project-bound credential is refused outright, since creating a pitch is a workspace-level action. Supports Idempotency-Key replay; a reused key with a different body returns 409 idempotency_conflict instead of replaying the first pitch (a dryRun answer is stored too, so creating after a preview takes a new key). Refusals: 403 plan_upgrade_required (with requiresUpgrade: true) when the workspace’s plan has no pitches, 403 pitch_allowance_used when its pitch allowance is spent, and 409 duplicate_domain when you already have a project or pitch on that domain in any workspace: howToFix and existing name it, unless it sits in a workspace the API may not reach, which is named nowhere. The other 403s: missing_scope without the project:provision capability, forbidden for a project-bound credential or a workspace where you may not create pitches (you are not a member, or your role cannot create projects), and security_policy_denied when the workspace’s API access policy refuses the request (API access switched off, or an IP allowlist you are outside).
curl --request POST \
--url https://app.searchable.com/api/mcp/pitches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"brandName": "<string>",
"brandSummary": "<string>",
"country": "<string>",
"competitors": [
"<string>"
],
"generatePrompts": true,
"brandNameDisambiguation": "<string>",
"city": "<string>",
"state": "<string>",
"language": "<string>",
"brandAliases": [
"<string>"
],
"name": "<string>",
"dryRun": true
}
'import requests
url = "https://app.searchable.com/api/mcp/pitches"
payload = {
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"brandName": "<string>",
"brandSummary": "<string>",
"country": "<string>",
"competitors": ["<string>"],
"generatePrompts": True,
"brandNameDisambiguation": "<string>",
"city": "<string>",
"state": "<string>",
"language": "<string>",
"brandAliases": ["<string>"],
"name": "<string>",
"dryRun": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
domain: '<string>',
brandName: '<string>',
brandSummary: '<string>',
country: '<string>',
competitors: ['<string>'],
generatePrompts: true,
brandNameDisambiguation: '<string>',
city: '<string>',
state: '<string>',
language: '<string>',
brandAliases: ['<string>'],
name: '<string>',
dryRun: true
})
};
fetch('https://app.searchable.com/api/mcp/pitches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.searchable.com/api/mcp/pitches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'workspaceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'domain' => '<string>',
'brandName' => '<string>',
'brandSummary' => '<string>',
'country' => '<string>',
'competitors' => [
'<string>'
],
'generatePrompts' => true,
'brandNameDisambiguation' => '<string>',
'city' => '<string>',
'state' => '<string>',
'language' => '<string>',
'brandAliases' => [
'<string>'
],
'name' => '<string>',
'dryRun' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.searchable.com/api/mcp/pitches"
payload := strings.NewReader("{\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"<string>\",\n \"brandName\": \"<string>\",\n \"brandSummary\": \"<string>\",\n \"country\": \"<string>\",\n \"competitors\": [\n \"<string>\"\n ],\n \"generatePrompts\": true,\n \"brandNameDisambiguation\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"language\": \"<string>\",\n \"brandAliases\": [\n \"<string>\"\n ],\n \"name\": \"<string>\",\n \"dryRun\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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))
}HttpResponse<String> response = Unirest.post("https://app.searchable.com/api/mcp/pitches")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"<string>\",\n \"brandName\": \"<string>\",\n \"brandSummary\": \"<string>\",\n \"country\": \"<string>\",\n \"competitors\": [\n \"<string>\"\n ],\n \"generatePrompts\": true,\n \"brandNameDisambiguation\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"language\": \"<string>\",\n \"brandAliases\": [\n \"<string>\"\n ],\n \"name\": \"<string>\",\n \"dryRun\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.searchable.com/api/mcp/pitches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"<string>\",\n \"brandName\": \"<string>\",\n \"brandSummary\": \"<string>\",\n \"country\": \"<string>\",\n \"competitors\": [\n \"<string>\"\n ],\n \"generatePrompts\": true,\n \"brandNameDisambiguation\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"language\": \"<string>\",\n \"brandAliases\": [\n \"<string>\"\n ],\n \"name\": \"<string>\",\n \"dryRun\": true\n}"
response = http.request(request)
puts response.read_body{
"pitch": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "active",
"createdAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z",
"daysLeft": 123,
"extended": true,
"refreshes": {
"limit": 123,
"used": 123,
"remaining": 123
},
"hiddenFromPicker": true,
"trackedPromptCount": 123,
"canReactivate": true,
"canExtend": true
},
"success": true,
"promptGeneration": "started",
"location": {
"countryCode": "<string>",
"city": "<string>",
"region": "<string>",
"label": "<string>"
},
"notes": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}Authorizations
A Searchable API key, created under Manage Account → Integrations → API Keys. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.
Headers
Optional client-generated key (e.g. a UUID). Retrying with the same key within 24h replays the original stored response (X-Idempotent-Replay: true) instead of repeating the side effect. See Idempotency.
Body
Response
Pitch created, or the preview of it for a dry run.
- Option 1
- Option 2
The pitch that was created, or, with dryRun: true, the preview of it.
Present only when a state or city that was sent could not be placed: a state that matches no known state; a city that was not recognised; a US city found in more than one state; a state or city that could not be checked, because the lookup failed or did not answer, which is never reported as not recognised. The default location is then the whole country.