Run poster integration notes
This document is meant to help platform teams estimate which data and hooks are needed to offer personalized race posters. The exact implementation can stay flexible: some platforms will prefer webhooks, others will prefer API access or post-race batches.
The three levels can be implemented progressively. Level 3 gives the best participant experience because the order can be produced and shipped with the least extra work from the runner.
Level 1
Participant completes the poster after the race
The platform only shares the participant email. TraveledMap contacts the runner and asks them to complete the personalization flow.Level 2
Participant reviews a poster that is already personalized
TraveledMap receives runner and race data, prepares the poster, then sends the participant a link to validate it. No extra payment is required because the poster has already been paid through the platform.Level 3
Participant receives the poster with almost no extra action
The platform sends the data needed for production and shipping. This creates the smoothest experience for the participant.* Participant email addresses are only used to contact runners about their poster order: delivery information, or a finalization link when the selected integration level requires the participant to complete or validate the poster.
The workflow below combines the functional steps, the optional technical hooks, and the data that should be available at each stage.
The platform presents TraveledMap as an optional add-on or partner product that an organizer can enable for an event.
Once an organizer selects TraveledMap, the platform notifies us so we can prepare the event or race poster.
https://api.traveledmap.com/posters/integrations/{platform}/eventsThe platform can use a stable image URL to display the poster preview to organizers or participants.
https://api.traveledmap.com/posters/integrations/{platform}/events/{eventId}/poster-preview.jpg?runId={runId}The purchase usually happens during registration or after registration. At this stage, TraveledMap does not try to produce the final poster yet; we only store the order context and the data that will help finalize the poster after the race.
https://api.traveledmap.com/posters/integrations/{platform}/ordersThe final production flow depends on the integration level and on which data the platform can share after the race is finished.
This is the type of content that could be shown inside a platform when an event organizer is choosing add-ons for their event.
Offer participants a poster based on the official race route. The poster can be personalized with runner data, printed in A4 or A3, and produced in six color options.
