Copy template to another app

curl --request POST \
  --url 'https://api.onesignal.com/templates/{template_id}/copy_to_app?app_id={app_id}' \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_app_id": "YOUR_OTHER_APP_ID"
}
'

{
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

This API allows you to copy a template from one app (app_id) to another (target_app_id). The duplicated template will have the same content as the original, but a new unique template_id.

---

​

Requirements

• Organization Membership: Both the app_id and target_app_id must belong to the same Organization.
• Authorization Required: You must use your Organization API key, not an app-level REST API key.
• Permissions Note: Your user must have admin-level access to both the source and target apps. If not, the request will fail with a “permission denied” error.

---

​

Parameters

• template_id (path param): UUID of the template to be copied.
• app_id (query param): ID of the app where the original template exists.
• target_app_id (body param): ID of the app where the template will be duplicated.

---

​

How to Use

​

1. Locate the Template ID

Each template has a unique OneSignal-generated template_id (UUID v4). You can find it:

• Using the View Templates API
• In the OneSignal Dashboard under Messages > Templates > Options > Copy Template ID

​

2. Get App IDs

Refer to Keys & IDs to find your app_id and target_app_id.

---

​

Response

The response will include:

• The new template_id for the copied template
• Confirmation of successful creation
• Any warnings if applicable (e.g., limited fields copied)

---