> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AlertMedia

> Reference for the Tracecat AlertMedia integration: registered actions, required secrets, expected inputs, and example workflow usage.

## 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](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](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](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](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](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](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](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](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>