All Collections
Integrations
Custom API Integations
Integrating with LoudCrowd Webhooks
Integrating with LoudCrowd Webhooks

Webhooks are automated messages sent from to your system, containing payloads of social/reward data that you can use outside of LoudCrowd

Al Nafea avatar
Written by Al Nafea
Updated over a week ago

LoudCrowd’s Webhooks provide data that indicates when one of your customers has completed a reward event (i.e. makes 2 Story posts). This enables you to trigger actions within your own system to reward customers appropriately, or store insightful social information. Establishing the system of data transfer is as simple as setting up an API URL and API key where LoudCrowd can securely push data to. Much of the tools you already use, perhaps like your ESP or eCommerce platform, already contain the ability to capture data via Webhooks.

Common Events that could trigger webhook events

  • An creator storefront makes a sale

  • Creator signs up for a program

  • Creator is approved for a program

  • Creator is rejected or removed from a program

  • Instantly when creator meets social posting thresholds

  • Monthly if an creator meets social posting thresholds

  • Every time an creator tags you in a social post

These events require different levels of configuration. Reach out to your LoudCrowd CSM for more information.

Webhook Payload

Every event that LoudCrowd sends will have a payload of available information. LoudCrowd’s current Webhook payload:

  • lcId - string - loudcrowd id for this reward fulfillment

  • email - string - email identifier of the ambassador

  • igUsername - string - Instagram username of the ambassador

  • ttUsername - string - TikTok username of the ambassador

  • discountCode - unique discount code if the event is tied to a and if the reward is code based

  • medias - a list of the medias that triggered the event (if setup to trigger by post activity)

    • lcid - string - loudcrowd id of this media

    • postedAt - string - datestring of the media's posted date

    • postType - string - either "FEED", "STORY", or “REEL”

example json:

{
"lcId":"ABC123",
"email":"[email protected]",
"igUsername":"joedirt",
"ttUsername":"joedirt",
"discountCode":"code123",
"medias":[
{
"lcId":"ABC123",
"postedAt":"2022-04-12T11:18:20.902164",
"postType":"FEED"
}
]
}

How to set up the webhook integration with LoudCrowd?

  1. Navigate to the Integrations page in your LoudCrowd account and under Outbound, hit Add Integration

2. Select Webhook from the list of available integrations

3. Next, enter the API Url and API Key that you or your technology team set-up for capturing LoudCrowd events and payloads.

4. LoudCrowd will automatically begin sending any event triggers for rewards created with Webhooks as the outbound source. For more information on creating and managing rewards, refer to here.

5. Then, you and your technology team can configure your system to handle LoudCrowd events and data payloads as you please.

6. Once complete, you can then test your system configuration via the test button within the newly created integration in LoudCrowd. Hitting the Test button will bring up a modal where you can enter test data. Enter the sample data, hit Test, and look within your system to find whether the correct data has come through.

7. If you need further support, contact your dedicated client strategist or [email protected] for assistance.

Did this answer your question?