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
tierId: - custom tier_id that can be assigned to the reward to map this event to a flow in the downstream receiving system
posts - 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 - options are "FEED", "STORY", or “REEL”
platform - string - options are "tik_tok", "instagram"
example json:
{
"lcId":"ABC123",
"email":"[email protected]",
"igUsername":"the.darth.one",
"ttUsername":"darth.and.moody",
"discountCode":"code123",
"tierId": "loudcrowd_first_post",
"posts":[
{
"lcId":"ABC123",
"postedAt":"2022-04-12T11:18:20.902164",
"postType":"FEED"
}
]
}
How to set up the webhook integration with LoudCrowd?
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.