Skip to main content

​
Create trip

Action ID: tools.alertmedia.create_trip Create a trip in AlertMedia. Reference: https://docs.alertmedia.com/reference/steps-create-a-trip-and-itinerary

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
city
string
required
City of the trip.
​
country_code
string
required
Country code of the trip. For example, US, CA, GB, etc.
​
end_date
string
required
End date of the trip. Example 2025-06-26 23:59:59
​
latitude
string
required
Latitude of the trip.
​
longitude
string
required
Longitude of the trip.
​
name
string
required
Name of the trip.
​
start_date
string
required
Start date of the trip. Example 2025-06-26 00:00:00
​
user_id
string
required
User ID of the user to create the trip for.
​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.
​
end_time_zone
string
Time zone of the trip.Default: "America/New_York".
​
start_time_zone
string
Time zone of the trip.Default: "America/New_York".

​
Delete trip

Action ID: tools.alertmedia.delete_trip Delete a trip from AlertMedia. Reference: https://docs.alertmedia.com/reference/steps-deleting-a-trip-or-itinerary

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
trip_id
string
required
ID of the trip to delete.
​
user_id
string
required
User ID of the user to delete the trip for.
​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.

​
Get Travel Events

Action ID: tools.alertmedia.get_travel_events Get travel events and concerns for users traveling. This can be traffic, weather, or other events that may affect the user’s travel. This returns a list of events and an item range header. The item range header of 0-2/3 means that the first 3 events (0-2) have been returned and there are a total of 3 events. Reference: https://docs.alertmedia.com/reference/get-list-events

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
active
boolean
Whether to get active trips.Default: null.
​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.
​
item_range
string
Item-Range header value. Default is 0-25.Default: "0-25".
​
since
string
Start date of the trips to get. Example 2025-06-26 00:00:00Default: "".

​
Get user trip by ID

Action ID: tools.alertmedia.get_user_trip_by_id Get a trip by ID from AlertMedia. Reference: https://docs.alertmedia.com/reference/get-list-a-users-travel-itinerary

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
trip_id
string
required
ID of the trip to get.
​
user_id
string
required
User ID of the user to get the trip for.
​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.

​
Get user trips

Action ID: tools.alertmedia.get_user_trips Get a list of trips for a user from AlertMedia. This returns a list of trips and an item range header. The item range header of 0-2/3 means that the first 3 trips (0-2) have been returned and there are a total of 3 trips. Reference: https://docs.alertmedia.com/reference/get-list-a-users-travel-itinerary

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
user_id
string
required
User ID of the user to get the trips for.
​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.
​
item_range
string
Item-Range header value. Default is 0-25.Default: "0-25".

​
Search trips

Action ID: tools.alertmedia.search_trips Search for trips in AlertMedia. This returns a list of trips and an item range header. The item range header of 0-2/3 means that the first 3 trips (0-2) have been returned and there are a total of 3 trips. Reference: https://docs.alertmedia.com/reference/get-list-a-users-travel-itinerary

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.
​
item_range
string
Item-Range header value. Default is 0-25.Default: "0-25".
​
ordering
string
Sort trips in response by one of start_date, end_date, name, city, country, state, country_code. Add - before the field name to reverse the order (e.g. ?ordering=-start_date returns trips sorted by start date Z-A). Default is -active_date.Default: "-active_date".
​
status
string
Filter trips by status, this is a comma separated list of statuses. Valid values are upcoming, active, past. Default is upcoming,active,past. (all statuses)Default: "upcoming,active,past".

​
Search users

Action ID: tools.alertmedia.search_users Search for users in AlertMedia. This returns a list of users and an item range header. The item range header of 0-2/3 means that the first 3 users (0-2) have been returned and there are a total of 3 users. Reference: https://docs.alertmedia.com/reference/get-list-users

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.
​
email
string
Email of the user to search for.Default: "".
​
has_device
boolean
Whether the user has an registered device.Default: "".
​
has_email
boolean
Whether the user has an email.Default: "".
​
has_phone
boolean
Whether the user has a phone number.Default: "".
​
item_range
string
Item-Range header value. Default is 0-25.Default: "0-25".
​
name
string
Name of the user to search for.Default: "".
​
ordering
string
Sort users in response by one of last_name, first_name, last_login, email, mobile_phone, date_updated. Add - before the field name to reverse the order (e.g. ?ordering=-last_name returns users sorted by last name Z-A)Default: "".
​
phone
string
Phone number of the user to search for.Default: "".

​
Update trip

Action ID: tools.alertmedia.update_trip Update a trip in AlertMedia. Reference: https://docs.alertmedia.com/reference/steps-create-a-trip-and-itinerary

​
Secrets

Required secrets:
  • alertmedia: required values ALERTMEDIA_API_KEY.

​
Input fields

​
trip_id
string
required
Trip ID of the trip to update.
​
user_id
string
required
User ID of the user to create the trip for.
​
base_url
string | null
AlertMedia base URL (e.g. https://tracecat.alertmedia.com)Default: null.
​
city
string | null
City of the trip.Default: null.
​
country_code
string | null
Country code of the trip. For example, US, CA, GB, etc.Default: null.
​
end_date
string | null
End date of the trip. Example 2025-06-26 23:59:59Default: null.
​
end_time_zone
string | null
Time zone of the trip.Default: null.
​
latitude
string | null
Latitude of the trip.Default: null.
​
longitude
string | null
Longitude of the trip.Default: null.
​
name
string | null
Name of the trip.Default: null.
​
start_date
string | null
Start date of the trip. Example 2025-06-26 00:00:00Default: null.
​
start_time_zone
string | null
Time zone of the trip.Default: null.