Create an event

Send notification parameters to your live Event feed. For tips and tricks, see the Protips section below the following code sample.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Event creation #Protips

  • image_url can point to an image with any dimensions, but we prefer squares, no greater than 125x125px. anything larger will likely slow down the speed of rendering on your website.
  • send url parameters without UTM or other tracking links. to add these, edit the UTM fields in your Applications > edit form instead, which makes it easy to bulk edit later.
  • 2-digit country codes are great - we'll convert them automatically to full country names. if you send a full country name, that's fine too.
  • all Templates include a "title_with_link" helper merge variable, which combines your "title" and "url" Event parameters. but, using markdown you can combine any 2 parameters, such as {{ something_custom }} with {{ url }}. learn more.
📘

Using the time_ago (timestamps) feature

If you're leveraging the "time_ago" attribute to show timestamps in your events, there's no need to POST any 'created_at' values. Fomo simply uses the derived values from the event record itself.

Query Params
int32
required

Event type unique ID

string

Optional identifier, useful for preventing duplicates

string

First name of the person on the event.

string

Person's email address, used to create dynamic customer avatars. Never shown publicly.

string

Person's IP address, used to extract city, province, and country parameters.

string

City where the event happend. Size range: 0..255

string

Province (state) where the event happened.

string

Country where the event happend ISO-2 standard. Size range: 0..255

string

Title of the event, such as a product name.

string

Url to redirect on the event click. Size range: 0..255

string

URL of the image to be displayed.

custom_event_fields_attributes
array

Array to create custom event fields

custom_event_fields_attributes
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json