---
title: "AlertMedia"
description: "Reference for the Tracecat AlertMedia integration: registered actions, required secrets, expected inputs, and example workflow usage."
---

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## 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](https://docs.alertmedia.com/reference/steps-create-a-trip-and-itinerary)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="city" type="string" required>

City of the trip.

</ParamField>

<ParamField path="country_code" type="string" required>

Country code of the trip. For example, US, CA, GB, etc.

</ParamField>

<ParamField path="end_date" type="string" required>

End date of the trip. Example 2025-06-26 23:59:59

</ParamField>

<ParamField path="latitude" type="string" required>

Latitude of the trip.

</ParamField>

<ParamField path="longitude" type="string" required>

Longitude of the trip.

</ParamField>

<ParamField path="name" type="string" required>

Name of the trip.

</ParamField>

<ParamField path="start_date" type="string" required>

Start date of the trip. Example 2025-06-26 00:00:00

</ParamField>

<ParamField path="user_id" type="string" required>

User ID of the user to create the trip for.

</ParamField>

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

<ParamField path="end_time_zone" type="string">

Time zone of the trip.

Default: `"America/New_York"`.

</ParamField>

<ParamField path="start_time_zone" type="string">

Time zone of the trip.

Default: `"America/New_York"`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/steps-deleting-a-trip-or-itinerary)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="trip_id" type="string" required>

ID of the trip to delete.

</ParamField>

<ParamField path="user_id" type="string" required>

User ID of the user to delete the trip for.

</ParamField>

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/get-list-events)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="active" type="boolean">

Whether to get active trips.

Default: `null`.

</ParamField>

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

<ParamField path="item_range" type="string">

Item-Range header value. Default is 0-25.

Default: `"0-25"`.

</ParamField>

<ParamField path="since" type="string">

Start date of the trips to get. Example 2025-06-26 00:00:00

Default: `""`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/get-list-a-users-travel-itinerary)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="trip_id" type="string" required>

ID of the trip to get.

</ParamField>

<ParamField path="user_id" type="string" required>

User ID of the user to get the trip for.

</ParamField>

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/get-list-a-users-travel-itinerary)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="user_id" type="string" required>

User ID of the user to get the trips for.

</ParamField>

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

<ParamField path="item_range" type="string">

Item-Range header value. Default is 0-25.

Default: `"0-25"`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/get-list-a-users-travel-itinerary)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

<ParamField path="item_range" type="string">

Item-Range header value. Default is 0-25.

Default: `"0-25"`.

</ParamField>

<ParamField path="ordering" type="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"`.

</ParamField>

<ParamField path="status" type="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"`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/get-list-users)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

<ParamField path="email" type="string">

Email of the user to search for.

Default: `""`.

</ParamField>

<ParamField path="has_device" type="boolean">

Whether the user has an registered device.

Default: `""`.

</ParamField>

<ParamField path="has_email" type="boolean">

Whether the user has an email.

Default: `""`.

</ParamField>

<ParamField path="has_phone" type="boolean">

Whether the user has a phone number.

Default: `""`.

</ParamField>

<ParamField path="item_range" type="string">

Item-Range header value. Default is 0-25.

Default: `"0-25"`.

</ParamField>

<ParamField path="name" type="string">

Name of the user to search for.

Default: `""`.

</ParamField>

<ParamField path="ordering" type="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: `""`.

</ParamField>

<ParamField path="phone" type="string">

Phone number of the user to search for.

Default: `""`.

</ParamField>

## 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](https://docs.alertmedia.com/reference/steps-create-a-trip-and-itinerary)

### Secrets

Required secrets:

- `alertmedia`: required values `ALERTMEDIA_API_KEY`.

### Input fields

<ParamField path="trip_id" type="string" required>

Trip ID of the trip to update.

</ParamField>

<ParamField path="user_id" type="string" required>

User ID of the user to create the trip for.

</ParamField>

<ParamField path="base_url" type="string | null">

AlertMedia base URL (e.g. https://tracecat.alertmedia.com)

Default: `null`.

</ParamField>

<ParamField path="city" type="string | null">

City of the trip.

Default: `null`.

</ParamField>

<ParamField path="country_code" type="string | null">

Country code of the trip. For example, US, CA, GB, etc.

Default: `null`.

</ParamField>

<ParamField path="end_date" type="string | null">

End date of the trip. Example 2025-06-26 23:59:59

Default: `null`.

</ParamField>

<ParamField path="end_time_zone" type="string | null">

Time zone of the trip.

Default: `null`.

</ParamField>

<ParamField path="latitude" type="string | null">

Latitude of the trip.

Default: `null`.

</ParamField>

<ParamField path="longitude" type="string | null">

Longitude of the trip.

Default: `null`.

</ParamField>

<ParamField path="name" type="string | null">

Name of the trip.

Default: `null`.

</ParamField>

<ParamField path="start_date" type="string | null">

Start date of the trip. Example 2025-06-26 00:00:00

Default: `null`.

</ParamField>

<ParamField path="start_time_zone" type="string | null">

Time zone of the trip.

Default: `null`.

</ParamField>
