Embed Copier

AdminUpdated Sep 24, 2026
GEThttps://shippified.net/api/embed-copier/config
Get 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.body
Java
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());
POSThttps://shippified.net/api/embed-copier/rotate
Rotate 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.body
Java
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());
POSThttps://shippified.net/api/embed-copier/{secret}/submit
Submit 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
NameInTypeRequiredDescription
secretpathstringyesYour 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.body
Java
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());
GEThttps://shippified.net/api/embed-samples
List 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.body
Java
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());
DELETEhttps://shippified.net/api/embed-samples/{id}
Delete an embed sample.
Parameters
NameInTypeRequiredDescription
idpathstringyes
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.body
Java
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());
POSThttps://shippified.net/api/embed-samples/{id}/promote
Submit a sample for review as a candidate built-in template (or withdraw it).
Parameters
NameInTypeRequiredDescription
idpathstringyes
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.body
Java
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?