400
invalid_requestThe request did not satisfy the documented contract.
Beladed Marketing API
Create Template through the reviewed Beladed Marketing contract.
/api/marketing/template/createcurl --request POST 'https://api.beladed.dev/api/marketing/template/create' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Beladed-API-Key: BELADED_SECRET_KEY' \
--data '{
"workspaceId": "id_demo_001",
"name": "Welcome Template",
"description": "Welcome email for new subscribers",
"category": "welcome",
"subject": "Welcome to {{company_name}}!",
"htmlContent": "<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>",
"textContent": "Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.",
"variables": [
{
"name": "first_name",
"type": "string",
"defaultValue": "Subscriber"
},
{
"name": "company_name",
"type": "string",
"defaultValue": "Beladed"
}
],
"tags": [
"welcome",
"onboarding"
],
"previewText": "Welcome to our platform!",
"fromName": "Beladed Team",
"fromEmail": "[email protected]",
"replyTo": "[email protected]"
}'const response = await fetch("https://api.beladed.dev/api/marketing/template/create", {
method: "POST",
headers: {
"Accept": "application/json",
"Content-Type": "application/json",
"X-Beladed-API-Key": "BELADED_SECRET_KEY"
},
body: JSON.stringify({
"workspaceId": "id_demo_001",
"name": "Welcome Template",
"description": "Welcome email for new subscribers",
"category": "welcome",
"subject": "Welcome to {{company_name}}!",
"htmlContent": "<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>",
"textContent": "Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.",
"variables": [
{
"name": "first_name",
"type": "string",
"defaultValue": "Subscriber"
},
{
"name": "company_name",
"type": "string",
"defaultValue": "Beladed"
}
],
"tags": [
"welcome",
"onboarding"
],
"previewText": "Welcome to our platform!",
"fromName": "Beladed Team",
"fromEmail": "[email protected]",
"replyTo": "[email protected]"
})
});
const data = await response.json();import requests
response = requests.request(
"POST",
"https://api.beladed.dev/api/marketing/template/create",
headers={"Accept":"application/json","Content-Type":"application/json","X-Beladed-API-Key":"BELADED_SECRET_KEY"},
json={
"workspaceId": "id_demo_001",
"name": "Welcome Template",
"description": "Welcome email for new subscribers",
"category": "welcome",
"subject": "Welcome to {{company_name}}!",
"htmlContent": "<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>",
"textContent": "Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.",
"variables": [
{
"name": "first_name",
"type": "string",
"defaultValue": "Subscriber"
},
{
"name": "company_name",
"type": "string",
"defaultValue": "Beladed"
}
],
"tags": [
"welcome",
"onboarding"
],
"previewText": "Welcome to our platform!",
"fromName": "Beladed Team",
"fromEmail": "[email protected]",
"replyTo": "[email protected]"
},
timeout=30,
)
response.raise_for_status()
data = response.json()<?php
$client = curl_init("https://api.beladed.dev/api/marketing/template/create");
curl_setopt_array($client, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => ["Accept: application/json","Content-Type: application/json","X-Beladed-API-Key: BELADED_SECRET_KEY"],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => json_encode({
"workspaceId": "id_demo_001",
"name": "Welcome Template",
"description": "Welcome email for new subscribers",
"category": "welcome",
"subject": "Welcome to {{company_name}}!",
"htmlContent": "<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>",
"textContent": "Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.",
"variables": [
{
"name": "first_name",
"type": "string",
"defaultValue": "Subscriber"
},
{
"name": "company_name",
"type": "string",
"defaultValue": "Beladed"
}
],
"tags": [
"welcome",
"onboarding"
],
"previewText": "Welcome to our platform!",
"fromName": "Beladed Team",
"fromEmail": "[email protected]",
"replyTo": "[email protected]"
}),
]);
$response = curl_exec($client);require "net/http"
require "json"
uri = URI("https://api.beladed.dev/api/marketing/template/create")
request = Net::HTTP::Post.new(uri)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request["X-Beladed-API-Key"] = "BELADED_SECRET_KEY"
request.body = "{\n \"workspaceId\": \"id_demo_001\",\n \"name\": \"Welcome Template\",\n \"description\": \"Welcome email for new subscribers\",\n \"category\": \"welcome\",\n \"subject\": \"Welcome to {{company_name}}!\",\n \"htmlContent\": \"<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>\",\n \"textContent\": \"Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.\",\n \"variables\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Subscriber\"\n },\n {\n \"name\": \"company_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Beladed\"\n }\n ],\n \"tags\": [\n \"welcome\",\n \"onboarding\"\n ],\n \"previewText\": \"Welcome to our platform!\",\n \"fromName\": \"Beladed Team\",\n \"fromEmail\": \"[email protected]\",\n \"replyTo\": \"[email protected]\"\n}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }var request = java.net.http.HttpRequest.newBuilder()
.uri(java.net.URI.create("https://api.beladed.dev/api/marketing/template/create"))
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.header("X-Beladed-API-Key", "BELADED_SECRET_KEY")
.method("POST", java.net.http.HttpRequest.BodyPublishers.ofString("{\n \"workspaceId\": \"id_demo_001\",\n \"name\": \"Welcome Template\",\n \"description\": \"Welcome email for new subscribers\",\n \"category\": \"welcome\",\n \"subject\": \"Welcome to {{company_name}}!\",\n \"htmlContent\": \"<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>\",\n \"textContent\": \"Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.\",\n \"variables\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Subscriber\"\n },\n {\n \"name\": \"company_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Beladed\"\n }\n ],\n \"tags\": [\n \"welcome\",\n \"onboarding\"\n ],\n \"previewText\": \"Welcome to our platform!\",\n \"fromName\": \"Beladed Team\",\n \"fromEmail\": \"[email protected]\",\n \"replyTo\": \"[email protected]\"\n}"))
.build();
var response = java.net.http.HttpClient.newHttpClient().send(request, java.net.http.HttpResponse.BodyHandlers.ofString());package main
import (
"bytes"
"net/http"
)
func callBeladed() (*http.Response, error) {
body := []byte("{\n \"workspaceId\": \"id_demo_001\",\n \"name\": \"Welcome Template\",\n \"description\": \"Welcome email for new subscribers\",\n \"category\": \"welcome\",\n \"subject\": \"Welcome to {{company_name}}!\",\n \"htmlContent\": \"<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>\",\n \"textContent\": \"Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.\",\n \"variables\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Subscriber\"\n },\n {\n \"name\": \"company_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Beladed\"\n }\n ],\n \"tags\": [\n \"welcome\",\n \"onboarding\"\n ],\n \"previewText\": \"Welcome to our platform!\",\n \"fromName\": \"Beladed Team\",\n \"fromEmail\": \"[email protected]\",\n \"replyTo\": \"[email protected]\"\n}")
request, err := http.NewRequest("POST", "https://api.beladed.dev/api/marketing/template/create", bytes.NewReader(body))
if err != nil { return nil, err }
request.Header.Set("Accept", "application/json")
request.Header.Set("Content-Type", "application/json")
request.Header.Set("X-Beladed-API-Key", "BELADED_SECRET_KEY")
return http.DefaultClient.Do(request)
}using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.beladed.dev/api/marketing/template/create");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Headers.TryAddWithoutValidation("X-Beladed-API-Key", "BELADED_SECRET_KEY");
request.Content = new StringContent("{\n \"workspaceId\": \"id_demo_001\",\n \"name\": \"Welcome Template\",\n \"description\": \"Welcome email for new subscribers\",\n \"category\": \"welcome\",\n \"subject\": \"Welcome to {{company_name}}!\",\n \"htmlContent\": \"<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>\",\n \"textContent\": \"Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.\",\n \"variables\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Subscriber\"\n },\n {\n \"name\": \"company_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Beladed\"\n }\n ],\n \"tags\": [\n \"welcome\",\n \"onboarding\"\n ],\n \"previewText\": \"Welcome to our platform!\",\n \"fromName\": \"Beladed Team\",\n \"fromEmail\": \"[email protected]\",\n \"replyTo\": \"[email protected]\"\n}", System.Text.Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();var request = URLRequest(url: URL(string: "https://api.beladed.dev/api/marketing/template/create")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.setValue("BELADED_SECRET_KEY", forHTTPHeaderField: "X-Beladed-API-Key")
request.httpBody = "{\n \"workspaceId\": \"id_demo_001\",\n \"name\": \"Welcome Template\",\n \"description\": \"Welcome email for new subscribers\",\n \"category\": \"welcome\",\n \"subject\": \"Welcome to {{company_name}}!\",\n \"htmlContent\": \"<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>\",\n \"textContent\": \"Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.\",\n \"variables\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Subscriber\"\n },\n {\n \"name\": \"company_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Beladed\"\n }\n ],\n \"tags\": [\n \"welcome\",\n \"onboarding\"\n ],\n \"previewText\": \"Welcome to our platform!\",\n \"fromName\": \"Beladed Team\",\n \"fromEmail\": \"[email protected]\",\n \"replyTo\": \"[email protected]\"\n}".data(using: .utf8)
let (data, response) = try await URLSession.shared.data(for: request)val request = okhttp3.Request.Builder()
.url("https://api.beladed.dev/api/marketing/template/create")
.addHeader("Accept", "application/json")
.addHeader("Content-Type", "application/json")
.addHeader("X-Beladed-API-Key", "BELADED_SECRET_KEY")
.method("POST", okhttp3.RequestBody.create(okhttp3.MediaType.get("application/json"), "{\n \"workspaceId\": \"id_demo_001\",\n \"name\": \"Welcome Template\",\n \"description\": \"Welcome email for new subscribers\",\n \"category\": \"welcome\",\n \"subject\": \"Welcome to {{company_name}}!\",\n \"htmlContent\": \"<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>\",\n \"textContent\": \"Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.\",\n \"variables\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Subscriber\"\n },\n {\n \"name\": \"company_name\",\n \"type\": \"string\",\n \"defaultValue\": \"Beladed\"\n }\n ],\n \"tags\": [\n \"welcome\",\n \"onboarding\"\n ],\n \"previewText\": \"Welcome to our platform!\",\n \"fromName\": \"Beladed Team\",\n \"fromEmail\": \"[email protected]\",\n \"replyTo\": \"[email protected]\"\n}"))
.build()
val response = okhttp3.OkHttpClient().newCall(request).execute()
This operation has no documented parameters.
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"category": {
"type": "string"
},
"subject": {
"type": "string"
},
"htmlContent": {
"type": "string"
},
"textContent": {
"type": "string"
},
"variables": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"defaultValue": {
"type": "string"
}
}
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"previewText": {
"type": "string"
},
"fromName": {
"type": "string"
},
"fromEmail": {
"type": "string"
},
"replyTo": {
"type": "string"
}
}
}{
"workspaceId": "id_demo_001",
"name": "Welcome Template",
"description": "Welcome email for new subscribers",
"category": "welcome",
"subject": "Welcome to {{company_name}}!",
"htmlContent": "<h1>Welcome {{first_name}}!</h1><p>Thank you for joining {{company_name}}. We're excited to have you on board.</p>",
"textContent": "Welcome {{first_name}}! Thank you for joining {{company_name}}. We're excited to have you on board.",
"variables": [
{
"name": "first_name",
"type": "string",
"defaultValue": "Subscriber"
},
{
"name": "company_name",
"type": "string",
"defaultValue": "Beladed"
}
],
"tags": [
"welcome",
"onboarding"
],
"previewText": "Welcome to our platform!",
"fromName": "Beladed Team",
"fromEmail": "[email protected]",
"replyTo": "[email protected]"
}
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
}
}
},
"requestId": {
"type": "string"
}
}
}{
"data": {
"id": "id_demo_001",
"status": "available"
},
"requestId": "req_demo_001"
}
invalid_requestThe request did not satisfy the documented contract.
authentication_requiredThe credential is missing or invalid.
not_authorizedThe account, product scope, permission, or origin is not eligible.
not_foundThe requested public or account-owned resource was not found.
rate_limitedRetry after the current product limit resets.
This operation is published from reviewed repository contracts. Source metadata is included for traceability without exposing internal implementation details.