Campaign Memberships

Campaign Memberships handle the relationship between subscribers and referral programs. For example, to add a subscriber to a referral program you must create a Campaign Membership relationship.

Create a campaign membership

POST https://api.sparkloop.app/v2/campaigns/:campaign_uuid/campaign_memberships

Use to endpoint to add a subscriber to a referral program

Path Parameters

Name	Type	Description
:campaign_uuid*	String	Referral campaign UUID, e.g. MF9a78983d1c.

Request Body

Name	Type	Description
subscriber_uuid*	string	Subscriber's UUID or email address

201: Created

{
    "campaign_membership": {
        "uuid": "membership_0cf7ec1e76d1",
        "campaign_uuid": "MF3c31fb034e",
        "subscriber_uuid": "sub_509eafef8d9d",
        "created_at": "2022-12-19T14:45:30.593Z"
    }
}

400

Campaign Membership already present

{
    "error": "[e-mail] has already been added to this campaign"
}

Subscriber not found

{
    "error": "manuel@sparkloop not found!"
}

Delete a campaign membership.

DELETE https://api.sparkloop.app/v2/campaigns/:campaign_uuid/campaign_memberships/:uuid

Use this endpoint to remove a subscriber from a campaign.

Path Parameters

Name	Type	Description
:campaign_uuid*	string	Subscriber's Referral campaign UUID, e.g. MF9a78983d1c.UUID or email address
:uuid*	String	Membership's UUID.

200

{
    "message": "Successfully deleted membership membership_34c8e39cf4"
}

400

{
    "error": "Failed to delete membership_34c8e39cf4"
}

404

Subscriber not found

{
    "error": "Membership membership_34c8e39cf4 not found!"
}

Campaign not found

{
    "error": "Campaign MF9a7d8983d1c not found!"
}