🛒 Supported on all platforms
💳 Available on Plus and Enterprise plans
👤 Accessible to all roles
Smile supports rewarding customers for a variety of standard actions (like placing an order or sharing via social channels), but you can also define custom actions (activity types) that are unique to your brand or setup. Custom activity types represent the brand-specific actions that your program is able to issue rewards for.
Common custom activity types include:
Subscribe to our newsletter
Enter a code from a physical product
Watch a video
Upload a receipt
Fill out a survey
Scann a QR code
Vote on a new product idea
What you need to know
Rewarding for custom actions requires writing code as well as an understanding of Smile's rewards architecture. For technical implementation guidance, we recommend sharing our fundamentals guide as well as our guide on rewarding for any action with your developer or agency partner.
ℹ️ Note: Smile's team is able to help answer questions about creating, editing, and deleting custom activity types as well as setting up related ways to earn, but unfortunately we can't help you with API development.
Add a new custom activity type
To create a new custom activity type:
In Smile Admin, navigate to Settings > Developer tools.
In the Custom activities card, click Create new activity type.
Fill in the Name before completed and Name after completed fields.
If you would like all Smile surfaces (e.g. the rewards panel, customer accounts page, etc) to directly link the customer to where they can complete the described action, check off Include a call to action and complete the fields.
Click Create.
After creating a custom activity type, you must also:
Create a way to earn that relies on the activity type.
Notify Smile when the activity occurs using our REST API.
If either of these is missing, customers won't be issued points for completing the new activity type.
⚠️ Warning: Including a call to action does NOT automatically trigger a reward for the customer when the action is clicked. Regardless of whether a call to action is included, you must still use Smile's REST API to notify Smile when the action occurs, otherwise rewards will not be issued.
Edit a custom activity type
To edit an existing custom activity type:
In Smile Admin, navigate to Settings > Developer tools.
In the Custom activities card, locate the activity type that you wish to edit.
Beside the activity type you wish to modify, click the edit icon.
Make the desired changes to the activity type.
Click Update.
Delete a custom activity type
Before deleting a custom activity type, you must remove any ways to earn that rely on the activity type. If you try to delete an activity type that is being used by a way to earn, you'll receive an error.
Once you've confirmed the activity type is no longer in use:
In Smile Admin, navigate to Settings > Developer tools.
In the Custom activities card, locate the activity type that you wish to delete.
Beside the activity type you wish to remove, click the delete icon.
Type the full name of the activity type and click Permanently delete.
🛑 Caution: Once an activity type is deleted, any API calls to notify Smile that the activity has occurred will begin failing. Be sure to update any systems sending activities to Smile before deleting the activity type itself.