Embed Copier
- Written for
- + Written for
- Deprecated
- + Deprecated
- Applies to
- + Applies to
AdminUpdated Sep 24, 2026
GET
https://shippified.net/api/embed-copier/configGet your embed-copier submission secret and the bot invite link.
Creates the secret on first call. Your submission URL is `/api/embed-copier/{secret}/submit` — give it to the embed-copier bot (`/setshippified`).
Responses
200 OK
{
"secret": "string",
"inviteUrl": "string"
}401 Not authenticated.
Code samples
cURL
curl -X GET "https://shippified.net/api/embed-copier/config"TypeScript
const res = await fetch('https://shippified.net/api/embed-copier/config', {
method: 'GET',
});
const data = await res.json();Python
import requests
res = requests.request(
"GET",
"https://shippified.net/api/embed-copier/config",
)
data = res.json()Go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://shippified.net/api/embed-copier/config", nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://shippified.net/api/embed-copier/config');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Ruby
require 'net/http'
require 'uri'
uri = URI('https://shippified.net/api/embed-copier/config')
req = Net::HTTP::Get.new(uri)
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(req)
end
puts res.bodyJava
import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://shippified.net/api/embed-copier/config"))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());POST
https://shippified.net/api/embed-copier/rotateRotate the submission secret.
The old submission URL stops working immediately; give the bot the new one.
Responses
200 Rotated.
{
"secret": "string"
}401 Not authenticated.
Code samples
cURL
curl -X POST "https://shippified.net/api/embed-copier/rotate"TypeScript
const res = await fetch('https://shippified.net/api/embed-copier/rotate', {
method: 'POST',
});
const data = await res.json();Python
import requests
res = requests.request(
"POST",
"https://shippified.net/api/embed-copier/rotate",
)
data = res.json()Go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://shippified.net/api/embed-copier/rotate", nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://shippified.net/api/embed-copier/rotate');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Ruby
require 'net/http'
require 'uri'
uri = URI('https://shippified.net/api/embed-copier/rotate')
req = Net::HTTP::Post.new(uri)
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(req)
end
puts res.bodyJava
import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://shippified.net/api/embed-copier/rotate"))
.method("POST", BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());POST
https://shippified.net/api/embed-copier/{secret}/submitSubmit a Discord embed as a template sample.
Called by the embed-copier bot. No auth header — the secret in the URL identifies the workspace. Limited to 30 submissions/min per workspace.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
secret | path | string | yes | Your submission secret from `GET /api/embed-copier/config`. |
Request body application/json
{
"embed": {},
"name": "string",
"sourceUrl": "string",
"fromGuildId": "string",
"fromGuildName": "string",
"fromUserId": "string",
"fromUserName": "string"
}Responses
201 Sample saved.
{
"id": "string",
"name": "string"
}400 Missing `embed` object.
{
"error": "string"
}404 Unknown or rotated secret.
{
"error": "string"
}429 More than 30 submissions in the last minute.
{
"error": "string"
}Code samples
cURL
curl -X POST "https://shippified.net/api/embed-copier/{secret}/submit" \
-H "Content-Type: application/json" \
-d '{"embed":{},"name":"string","sourceUrl":"string","fromGuildId":"string","fromGuildName":"string","fromUserId":"string","fromUserName":"string"}'TypeScript
const res = await fetch('https://shippified.net/api/embed-copier/{secret}/submit', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({"embed":{},"name":"string","sourceUrl":"string","fromGuildId":"string","fromGuildName":"string","fromUserId":"string","fromUserName":"string"}),
});
const data = await res.json();Python
import requests
res = requests.request(
"POST",
"https://shippified.net/api/embed-copier/{secret}/submit",
headers={
"Content-Type": "application/json",
},
json={"embed": {}, "name": "string", "sourceUrl": "string", "fromGuildId": "string", "fromGuildName": "string", "fromUserId": "string", "fromUserName": "string"},
)
data = res.json()Go
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
req, _ := http.NewRequest("POST", "https://shippified.net/api/embed-copier/{secret}/submit", strings.NewReader(`{"embed":{},"name":"string","sourceUrl":"string","fromGuildId":"string","fromGuildName":"string","fromUserId":"string","fromUserName":"string"}`))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://shippified.net/api/embed-copier/{secret}/submit');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"embed":{},"name":"string","sourceUrl":"string","fromGuildId":"string","fromGuildName":"string","fromUserId":"string","fromUserName":"string"}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;Ruby
require 'net/http'
require 'uri'
uri = URI('https://shippified.net/api/embed-copier/{secret}/submit')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"embed":{},"name":"string","sourceUrl":"string","fromGuildId":"string","fromGuildName":"string","fromUserId":"string","fromUserName":"string"}'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(req)
end
puts res.bodyJava
import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://shippified.net/api/embed-copier/{secret}/submit"))
.header("Content-Type", "application/json")
.method("POST", BodyPublishers.ofString("{\"embed\":{},\"name\":\"string\",\"sourceUrl\":\"string\",\"fromGuildId\":\"string\",\"fromGuildName\":\"string\",\"fromUserId\":\"string\",\"fromUserName\":\"string\"}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());GET
https://shippified.net/api/embed-samplesList embed samples collected by the bot.
Load one into the template builder as a sample payload.
Responses
200 OK
{
"samples": [
{
"id": "embed_mpvu9uim_q1w2e",
"userId": "string",
"name": "string",
"sourceUrl": "string",
"fromGuildId": "string",
"fromGuildName": "string",
"fromUserId": "string",
"fromUserName": "string",
"embed": {},
"promotedToLibrary": true,
"submittedAt": "2024-01-01T00:00:00Z"
}
]
}401 Not authenticated.
Code samples
cURL
curl -X GET "https://shippified.net/api/embed-samples"TypeScript
const res = await fetch('https://shippified.net/api/embed-samples', {
method: 'GET',
});
const data = await res.json();Python
import requests
res = requests.request(
"GET",
"https://shippified.net/api/embed-samples",
)
data = res.json()Go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://shippified.net/api/embed-samples", nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://shippified.net/api/embed-samples');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Ruby
require 'net/http'
require 'uri'
uri = URI('https://shippified.net/api/embed-samples')
req = Net::HTTP::Get.new(uri)
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(req)
end
puts res.bodyJava
import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://shippified.net/api/embed-samples"))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());DELETE
https://shippified.net/api/embed-samples/{id}Delete an embed sample.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes |
Responses
200 Deleted.
{
"ok": true
}401 Not authenticated.
404 Sample not found.
Code samples
cURL
curl -X DELETE "https://shippified.net/api/embed-samples/{id}"TypeScript
const res = await fetch('https://shippified.net/api/embed-samples/{id}', {
method: 'DELETE',
});
const data = await res.json();Python
import requests
res = requests.request(
"DELETE",
"https://shippified.net/api/embed-samples/{id}",
)
data = res.json()Go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("DELETE", "https://shippified.net/api/embed-samples/{id}", nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://shippified.net/api/embed-samples/{id}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Ruby
require 'net/http'
require 'uri'
uri = URI('https://shippified.net/api/embed-samples/{id}')
req = Net::HTTP::Delete.new(uri)
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(req)
end
puts res.bodyJava
import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://shippified.net/api/embed-samples/{id}"))
.method("DELETE", BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());POST
https://shippified.net/api/embed-samples/{id}/promoteSubmit a sample for review as a candidate built-in template (or withdraw it).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes |
Request body application/json
{
"promoted": true
}Responses
200 Updated sample.
{
"sample": {
"id": "embed_mpvu9uim_q1w2e",
"userId": "string",
"name": "string",
"sourceUrl": "string",
"fromGuildId": "string",
"fromGuildName": "string",
"fromUserId": "string",
"fromUserName": "string",
"embed": {},
"promotedToLibrary": true,
"submittedAt": "2024-01-01T00:00:00Z"
}
}401 Not authenticated.
404 Sample not found.
Code samples
cURL
curl -X POST "https://shippified.net/api/embed-samples/{id}/promote" \
-H "Content-Type: application/json" \
-d '{"promoted":true}'TypeScript
const res = await fetch('https://shippified.net/api/embed-samples/{id}/promote', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({"promoted":true}),
});
const data = await res.json();Python
import requests
res = requests.request(
"POST",
"https://shippified.net/api/embed-samples/{id}/promote",
headers={
"Content-Type": "application/json",
},
json={"promoted": True},
)
data = res.json()Go
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
req, _ := http.NewRequest("POST", "https://shippified.net/api/embed-samples/{id}/promote", strings.NewReader(`{"promoted":true}`))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://shippified.net/api/embed-samples/{id}/promote');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"promoted":true}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;Ruby
require 'net/http'
require 'uri'
uri = URI('https://shippified.net/api/embed-samples/{id}/promote')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"promoted":true}'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(req)
end
puts res.bodyJava
import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://shippified.net/api/embed-samples/{id}/promote"))
.header("Content-Type", "application/json")
.method("POST", BodyPublishers.ofString("{\"promoted\":true}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());Was this page helpful?