Developers
Ask
Sign inSign in

Add plan to campaign

How do I add another outlet to a campaign that already exists?

1 min readUpdated 15 November 2026
Short answer

dorna_add_to_campaign adds one plan to an existing campaign and re-prices its draft invoice. If the campaign is already paid, the new order waits for its own payment.

  • dorna_add_to_campaign
  • Changes data
Contents
  1. Parameters
  2. What it returns
  3. Example
  4. Access and confirmation

Parameters

FieldTypeDescription
campaignIdstring (ID)Required. The campaign to add the plan to.
planIdstring (ID)Required. The plan's ID, exactly as returned by dorna_search_media, dorna_get_media or dorna_get_plan.
orderPriceRialsinteger, at least 0Required. The plan's price for this order in rials, exactly as returned with the plan. Send it unchanged.
addonIdsarrayIDs of the plan's add-ons you want, from dorna_get_media.
durationMonthsinteger, 1 to 36Rental length in months, for backlink plans.
targetUrlstringThe page the backlink points to. Must start with http:// or https://.
anchorTextstringThe link's anchor text.

What it returns

The new totals in rials and the campaign's orders.

Example

Ask your assistant: Add this plan to my August campaign and point it at the pricing page.

The assistant then calls the tool like this:

{
  "name": "dorna_add_to_campaign",
  "arguments": {
    "campaignId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "planId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "orderPriceRials": 12000000
  }
}

A typical result looks like this (the values are examples):

{
  "campaignId": "64f1a2b3c4d5e6f7a8b9c0d1",
  "paid": true,
  "subtotalRials": 12000000,
  "discountRials": 1200000,
  "vatRials": 1080000,
  "totalRials": 11880000,
  "payableRials": 11880000,
  "orderIds": [
    "64f1a2b3c4d5e6f7a8b9c0d1"
  ]
}

Access and confirmation

Changes data: it adds something new to your account or creates a link.

Your assistant confirms the outlet, plan and price with you first.

Related tools: dorna_create_campaign dorna_search_media

Still have a question?

Open this guide in your own AI assistant and ask it.

ChatGPTClaudeGemini