LogoLogo
REST APIWebhooksHelp Center →
  • Introduction
  • JavaScript API
    • Overview
  • REST API
    • Overview
    • Campaigns
      • The campaign object
      • List campaigns
      • Create campaign
      • Retrieve campaign
      • Update campaign
    • Affiliates
      • The affiliate object
      • List affiliates
      • Create affiliate
      • Retrieve affiliate
      • Update affiliate
      • Magic Link (SSO)
    • Affiliate Links
      • The affiliate link object
      • List affiliate links
      • Create affiliate link
      • Retrieve affiliate link
      • Update affiliate link
    • Affiliate Coupons
      • The affiliate coupon object
      • List affiliate coupons
      • Create affiliate coupon
      • Retrieve affiliate coupon
    • Referrals
      • The referral object
      • List referrals
    • Commissions
      • The commission object
      • List commissions
      • Retrieve commission
      • Update commission
      • Delete commission
    • Payouts
      • The payout object
      • List payouts
      • Retrieve a payout
      • Mark a payout as paid
  • Webhooks
    • Overview
    • Endpoints
    • Requests
    • Event types
    • Signed webhooks
  • Links
    • Help Center
    • Sign up
    • Login
    • Learn more about Rewardful
Powered by GitBook
On this page
  • Request
  • Parameters
  • Example
  • Response

Was this helpful?

Export as PDF
  1. REST API
  2. Affiliates

Update affiliate

Updates the specified affiliate by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Updates the specified affiliate by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Request

Method

URL

PUT

https://api.getrewardful.com/v1/affiliates/:id

Parameters

Parameter

Required?

Description

first_name

No

The affiliate's first name.

last_name

No

The affiliate's last name.

email

No

The affiliate's email address.

state

No

stripe_customer_id

No

For customer referral programs, this is the Stripe Customer that will receive account credits as rewards. Note: the customer must exist in your Stripe account in livemode.

campaign_id

No

paypal_email

No

The PayPal address that commissions should be paid to.

wise_email

No

The Wise address that commissions should be paid to.

receive_new_commission_notifications

No

Whether or not the affiliate should receive emails when new rewards and commissions are earned. Accepts true or false.

Example

curl --request PUT \
  --url https://api.getrewardful.com/v1/affiliates/d0ed8392-8880-4f39-8715-60230f9eceab \
  -u YOUR_API_SECRET: \
  -d first_name=Jamie \
  -d email=james.bond@mi6.co.uk

Response

Response code

Body

200

Not found

Response code

Body

404

JSON object describing the error.

{  "error": "Affiliate not found: " }

Authentication failure

Response code

Body

401

Description of the authentication failure.

{  "error": "Invalid API Secret." }
PreviousRetrieve affiliateNextMagic Link (SSO)

Last updated 2 years ago

Was this helpful?

A string indicating the . Defaults to active.

The UUID of the campaign this affiliate should be moved to.

An (JSON)

Learn more about moving affiliates between campaigns.
affiliate object
affiliate's state