Partner Programs

Get partner programs

GET https://api.sparkloop.app/v2/partner_programs

Partner programs are ordered descendingly by created_at, meaning the first page shows the latest publications.

200 Used query params ?page=1&per_page=2

{
  "partner_programs": [
    <Partner Program Object>,
    <Partner Program Object>
  ],
  "meta": {
    "per_page": 2,
    "page": 1,
    "total_pages": 12,
    "total_partner_programs": 24
  }
}

Get a partner program

GET https://api.sparkloop.app/v2/partner_programs/:identifier

Returns a single partner program by UUID

Path Parameters

Name	Type	Description
identifier*	string	Partner program's UUID

200

{
  "partner_program":
    <Partner Program Object>
}

404

Update partner program

PUT https://api.sparkloop.app/v2/partner_programs/:identifier

Path Parameters

Name	Type	Description
identifier*	string	Partner programs's UUID

Request Body

Name	Type	Description
total_budget	number	Monthly spend cap. Set a cap on the total monthly spend across your partner programs. Once your spend cap is reached, partners will be notified and you won't be charged for any further referrals in that calendar month. In US dollars ($).
cpa	number	The default fee you want to pay partners for each new subscriber they send you, e.g. 2.5 In US dollars ($).
redirect_url	String	Default partner link destination. It's where people will go when they click on a partner link.
slug	String	Your unique custom signup page URL, e.g. if you set slug to morning-stew the custom signup page URL will be https://partnerprogram.page/morning-stew
thankyou_page_url	String	Thank-you page URL. It's what we show new subscribers when they subscribe via Magic Link.
resources_url	String	Partner resources URL. If you've created any resources to help partner promote you effectively, link them here.
terms	String	Custom partner program conditions.
show_in_directory	boolean	Set to true if you want to feature the partner program in SparkLoop Partner Network. Get discovered by thousands of pre-approved newsletter partners and let them join your partner program with one click.
referral_pending_duration_enabled	boolean	Set to true if you want to exclude referrals if they unsubscribe shortly after signup.
referral_pending_duration	number	Referrals will be confirmed if they've stayed subscribed for at least this number of days.

200

{
  "partner_program":
    <Partner Program Object>
}

400

404