default

Update offer

Change any of the project's offer fields (App settings, Your offer); fields you leave out keep their value. Strings: empty clears. Numbers: null clears. Saved through the same validation as the dashboard. Applies to the next email. Returns the stored offer.

post/api/v1/tools/update_offer

Request

  • Base URL: https://www.affiliatespy.io
  • URL: https://www.affiliatespy.io/api/v1/tools/update_offer
  • Auth: HTTP bearer

Request body

app_idstring uuid

Project id from list_apps. Omit to use your most recently added project.

brand_namestring

How the brand is named in every email.

sender_namestring

Signs the emails. A person, not a mailbox name like affiliate.

commissionstring

One clause, e.g. "30% recurring commission with a 45-day cookie".

signup_urlstring

Affiliate signup link, sent in replies to sites that say yes, never in a first email.

cookie_daysinteger nullable

How long a referred click stays yours.

payout_notesstring

Payout timing, minimums and details the AI may quote in replies.

assets_urlstring

Banners and promo material, shared in replies.

postal_addressstring

Business postal address, required before live cold email.

lead_with_rateboolean

false: step 1 of the website lanes does not state the rate.

ladder_startnumber nullable

Rate (%) the first offer makes. null: the commission line as written.

ladder_stepnumber nullable

Added (%) at each raise while a site does not reply, in the same thread.

ladder_maxnumber nullable

Highest rate (%); the last raise always offers it.

nudge_daysinteger nullable

Days after the first email that the offer follows, in the same thread. Default 4.

raise_every_daysinteger nullable

Days between raises, counted from the first email. Default 14.

boost_pointsnumber nullable

Launch boost (%) added for a new affiliate's first boost_days days.

boost_daysinteger nullable

How long the launch boost lasts.

boost_everyoneboolean

Every affiliate who joins from now on gets the launch boost, not only sites you pitched. The server records when it was first turned on.

market_ratenumber nullable

A re-pitch may say other programs pay up to this (%), never naming one.

placement_dealsboolean

Accept paid placements as a last resort: the sequence's last step asks what a top spot costs.

stats_window_hoursinteger nullable

Hours of recent conversions the program figures cover. Default 72.

confirmboolean

Set true after the user confirmed an action the guard flagged as hard to undo.

Response

The tool's JSON result (same payload the MCP tool returns).

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.