# Mapulus

Mapulus is a platform that enables users to create, manage, and analyze interactive maps, integrating with various applications to automate tasks and leverage location insights.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `MAPULUS`
- **Version:** 20260211_00

## Tools

### Find Location by External ID

**Slug:** `MAPULUS_FIND_LOCATION_WITH_EXTERNAL_ID`

Find locations by their external identifier. Returns a list of locations that match the provided external_id. External IDs are unique identifiers used for integrating Mapulus with external systems (CRM, databases, etc.). Returns an empty list if no matching locations are found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `external_id` | string | Yes | External identifier used to find matching location(s). This is a unique identifier assigned to locations for external system integration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Map Details

**Slug:** `MAPULUS_GET_MAP_DETAILS`

Tool to retrieve detailed information about a map. Use when you have a map_id and need full map metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `map_id` | string | Yes | The unique identifier of the map to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Maps

**Slug:** `MAPULUS_LIST_MAPS`

Retrieves a paginated list of all maps accessible to the authenticated user. Supports filtering by name/tag and sorting by various fields. Returns map metadata including IDs, titles, and timestamps. Use this to discover available maps before fetching detailed information or locations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Filter maps by a specific tag (exact match). Returns only maps that have this exact tag. |
| `name` | string | No | Filter maps by title using partial text match (case-insensitive). Returns maps whose title contains this text. |
| `page` | integer | No | Page number to retrieve (starting from 1). Leave empty to get the first page. |
| `sortBy` | string | No | Field name to sort results by. Common values: 'title', 'created_at', 'updated_at'. Defaults to 'created_at' if not specified. |
| `perPage` | integer | No | Number of maps to return per page (1-100). Leave empty for API default (typically 50). |
| `sortOrder` | string ("asc" | "desc") | No | Sort direction: 'asc' for ascending (A-Z, oldest first) or 'desc' for descending (Z-A, newest first). Defaults to 'desc'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |