In this tutorial, you will learn how to delete a social media call to action through the Kangaroo Rewards API.

Objective: To demonstrate the process of deleting a social media call to action via the Kangaroo Rewards API.

Prerequisites:

• Basic understanding of APIs and HTTP requests.
• A registered business account with Kangaroo Rewards.
• An API client like Postman or cURL installed.
• An OAuth2 App registered with Kangaroo Rewards
• A valid Access Token

First, ensure you have your API access key and X-Application-Key from Kangaroo Rewards. This key is necessary for authenticating your API requests.

export ACCESS_KEY="YOUR_ACCESS_KEY_HERE"
export APPLICATION_KEY="YOUR_APPLICATION_KEY_HERE"

For instructions on issuing an access token, please refer to this tutorial link.

To get the list of created Social Media Call to Action, make a GET request to the appropriate endpoint, including the necessary information.

curl -X GET "https://api.kangaroorewards.com/call-to-actions" \
-H "Authorization: Bearer <ACCESS_KEY>" \
-H "X-Application-Key: <APPLICATION_KEY>" \
-H "Accept: application/vnd.kangaroorewards.api.v1+json;" \
-H "Content-Type: application/json" \

{
  "data": [
    {
      "id": 489,
      "enabled": true,
      "points": 100,
      "result_freq": null,
      "result_count": 0,
      "action_freq": null,
      "action_count": 1,
      "action_duration_min": 0,
      "action_duration_unit": null,
      "conditions": null,
      "action_id": 4,
      "created_at": "2024-11-08T09:22:55+00:00"
    },
    {
      "id": 487,
      "enabled": true,
      "points": 0,
      "result_freq": null,
      "result_count": 1,
      "action_freq": null,
      "action_count": 1,
      "action_duration_min": 0,
      "action_duration_unit": null,
      "conditions": null,
      "action_id": 8,
      "created_at": "2024-11-08T08:49:16+00:00"
    },
    {
      "id": 486,
      "enabled": true,
      "points": 25,
      "result_freq": null,
      "result_count": 1,
      "action_freq": null,
      "action_count": 1,
      "action_duration_min": 0,
      "action_duration_unit": null,
      "conditions": null,
      "action_id": 7,
      "created_at": "2024-11-08T08:49:16+00:00"
    },
    {
      "id": 485,
      "enabled": true,
      "points": 5,
      "result_freq": null,
      "result_count": 1,
      "action_freq": null,
      "action_count": 1,
      "action_duration_min": 0,
      "action_duration_unit": null,
      "conditions": null,
      "action_id": 6,
      "created_at": "2024-11-08T08:49:16+00:00"
    },
  ],
}

• call_to_action_id: Required - The call to action id associated to the desired Social Media Platform.
• points: Required - The amount of points to reward for the desired social media CTA.

To delete a Social Media Call to Action, make a DELETE request to the appropriate endpoint, including the necessary information.

curl -X DELETE "https://api.kangaroorewards.com/call-to-actions/{call_to_action_id}" \
-H "Authorization: Bearer <ACCESS_KEY>" \
-H "X-Application-Key: <APPLICATION_KEY>" \
-H "Accept: application/vnd.kangaroorewards.api.v1+json;" \
-H "Content-Type: application/json" \

• call_to_action_id: Required - The call to action id associated to the desired Social Media Platform.

In this tutorial, we demonstrated how to get the list of all social media call to actions, and delete the desired entity using the Kangaroo Rewards API. We provided a step-by-step guide, by following these instructions, users can efficiently manage their Social media Call to Action events.

• Always store your client secret and access token securely and never expose them in your source code.
• Handle API responses appropriately, including error handling to manage failed requests.
• Limit the number of API requests to avoid exceeding your quota.

• Kangaroo Rewards API Documentation
• Implement Authentication
• Access Kangaroo API
• cURL

• Ensure your Access Token is correct, isn't expired and has the necessary permissions.
• Check the API endpoint URLs for any typos.
• Double check all the required headers are present including Content-Type and Accept.
• Review the error messages returned by the API for clues on what went wrong.