TypeScript SDK

import { randomUUID } from 'node:crypto';
import { Configuration, PartnersApi } from '@widgetic/api-sdk-ts';

const partnersApi = new PartnersApi(new Configuration({ apiKey: 'YOUR_API_KEY' }));

const { data: delivery } = await partnersApi.replayPartnerNotificationDelivery({
  partnerId,
  deliveryId: 'c3c3c3c3-3333-4333-8333-333333333333',
  idempotencyKey: randomUUID(),
});

curl --request POST \
  --url https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>'

import requests

url = "https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay"

headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};

fetch('https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay', 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://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "deliveryId": "a1a1a1a1-1111-4111-8111-111111111111",
    "notificationId": "b2b2b2b2-2222-4222-8222-222222222222",
    "eventType": "composition.created",
    "title": "Composition created",
    "channel": "webhook",
    "target": "hooks.example.com",
    "status": "delivered",
    "attemptCount": 1,
    "nextAttemptAt": null,
    "lastAttemptAt": "2026-10-09T12:00:00.000Z",
    "deliveredAt": "2026-10-09T12:00:00.000Z",
    "lastStatusCode": 200,
    "lastError": null,
    "createdAt": "2026-10-09T12:00:00.000Z",
    "replayOfDeliveryId": "c3c3c3c3-3333-4333-8333-333333333333"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

Partners

Send a webhook delivery again

Sends one earlier webhook delivery again to your current webhook address, with the same event id (webhook-id) as the original notification so a receiver that remembers ids can ignore a duplicate, and a new createdAt and signature made with your current secret. The attempt is recorded in the delivery log as a new row that points at the delivery you replayed.

Set a webhook address (and secret) under notification settings before you replay. Changing the settings needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator.

POST

partners

{partnerId}

notifications

deliveries

{deliveryId}

replay

TypeScript SDK

import { randomUUID } from 'node:crypto';
import { Configuration, PartnersApi } from '@widgetic/api-sdk-ts';

const partnersApi = new PartnersApi(new Configuration({ apiKey: 'YOUR_API_KEY' }));

const { data: delivery } = await partnersApi.replayPartnerNotificationDelivery({
  partnerId,
  deliveryId: 'c3c3c3c3-3333-4333-8333-333333333333',
  idempotencyKey: randomUUID(),
});

curl --request POST \
  --url https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>'

import requests

url = "https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay"

headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};

fetch('https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay', 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://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.widgetic.com/v1/partners/{partnerId}/notifications/deliveries/{deliveryId}/replay")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "deliveryId": "a1a1a1a1-1111-4111-8111-111111111111",
    "notificationId": "b2b2b2b2-2222-4222-8222-222222222222",
    "eventType": "composition.created",
    "title": "Composition created",
    "channel": "webhook",
    "target": "hooks.example.com",
    "status": "delivered",
    "attemptCount": 1,
    "nextAttemptAt": null,
    "lastAttemptAt": "2026-10-09T12:00:00.000Z",
    "deliveredAt": "2026-10-09T12:00:00.000Z",
    "lastStatusCode": 200,
    "lastError": null,
    "createdAt": "2026-10-09T12:00:00.000Z",
    "replayOfDeliveryId": "c3c3c3c3-3333-4333-8333-333333333333"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "success": false,
  "message": "<string>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Composition not found",
    "timestamp": "2026-10-15T10:00:00.000Z",
    "param": "name",
    "docUrl": "<string>",
    "suggestedAction": "<string>",
    "retryAfter": 60,
    "details": {},
    "correlationId": "req_123e4567-e89b-12d3-a456-426614174000"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string

required

Required: a call without it is refused with 400. A key of your own that names this one request; a UUID is ideal. It is 8 to 50 characters of letters, digits, - and _. Send the same key again when you retry (after a timeout, a dropped connection or a 5xx) and the call is carried out once: the retry gets the first answer back, marked X-Idempotency-Cached: true. The same key with a different body is refused with 422, and a retry that arrives while the first call is still running with 409 (see Retry-After).

Required string length: 8 - 50

Pattern: ^[a-zA-Z0-9_-]{8,50}$

Example:

"9b2d6f0a-3c41-4e5a-8d77-1f2e3a4b5c6d"

Path Parameters

partnerId

string<uuid>

required

The partner whose delivery to replay

deliveryId

string<uuid>

required

The delivery to send again (must be a webhook delivery of this partner)

Response

The replay was attempted; the new delivery row

success

boolean

required

Always true on a success.

Example:

true

data

object

required

One send of one notification, to one email address or to your webhook. It stays pending while it is being tried again, and ends delivered, failed (given up on) or cancelled (nobody wanted it any more, for example because the webhook was switched off).

Show child attributes

Example:

{
  "deliveryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "notificationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventType": "Example eventType",
  "title": "Example title",
  "channel": "Example channel",
  "target": "Example target",
  "status": "Example status",
  "attemptCount": 42,
  "nextAttemptAt": "2026-01-15T09:30:00.000Z",
  "lastAttemptAt": "2026-01-15T09:30:00.000Z",
  "deliveredAt": "2026-01-15T09:30:00.000Z",
  "lastStatusCode": 42,
  "lastError": "Example lastError",
  "createdAt": "2026-01-15T09:30:00.000Z",
  "replayOfDeliveryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

API Reference

Public Embed

Workflows

Partners

Widgets

Users

Uploads

Tokens

Operations

Managed Users

Invoices

Entitlements

Credits

Compositions

Canvases

Brand Kit

Send a webhook delivery again

Authorizations

Headers

Path Parameters

Response