# Amcards

AMCards enables users to create personalized greeting cards, automate mailing campaigns, strengthen customer relationships using a convenient online platform for individualized connections

- **Category:** marketing automation
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `AMCARDS`
- **Version:** 20260217_00

## Tools

### Get API Schema

**Slug:** `AMCARDS_GET_API_SCHEMA`

Tool to retrieve the entire schema for AMCards API V1. Use when you need to discover available API endpoints, resources, and their structure.

#### 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 Cards

**Slug:** `AMCARDS_GET_CARDS`

This tool retrieves a list of all cards associated with the authenticated account. The action is completely independent and doesn't require any external resource IDs or parameters beyond authentication. It allows users to monitor, track, and manage their cards.

#### 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 Category

**Slug:** `AMCARDS_GET_CATEGORY`

Tool to retrieve details of a specific category by ID. Use when you need to fetch information about a card template category including its title, hierarchy, and priority.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category_id` | integer | Yes | The unique identifier of the category 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 |

### Get Category Schema

**Slug:** `AMCARDS_GET_CATEGORY_SCHEMA`

Tool to retrieve the schema for Category resource. Categories are readonly. Use when you need to understand the structure and available fields of the Category resource.

#### 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 Contacts

**Slug:** `AMCARDS_GET_CONTACTS`

This tool retrieves a list of contacts from AMCards. It is used for managing contacts by providing details like limit, skip, and filters (e.g., last_name, first_name, email). The tool returns an array of contact objects containing fields such as id, first_name, last_name, email, created_at, and updated_at.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | The number of contacts to skip before starting to collect the result set |
| `email` | string | No | Filter contacts by email address |
| `limit` | integer | No | The maximum number of contacts to retrieve |
| `last_name` | string | No | Filter contacts by last name |
| `first_name` | string | No | Filter contacts by first name |

#### 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 Gift

**Slug:** `AMCARDS_GET_GIFT`

Tool to retrieve details of a specific gift by ID. Use when you need to fetch information about a particular gift including its name, description, price, shipping cost, and availability.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the gift 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 |

### Get Public Template

**Slug:** `AMCARDS_GET_PUBLIC_TEMPLATE`

Tool to retrieve details of a specific public template by ID. Use when you need to get information about a specific template including its configuration, panels, and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the public template 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 Categories

**Slug:** `AMCARDS_LIST_CATEGORIES`

Tool to retrieve a list of card template categories from AMCards. Categories are returned ordered by their priority (1 is highest). Use when you need to browse available categories, filter by parent category, or search categories by title.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `parent__id` | integer | No | Filter sub-categories by parent category ID. Use this to get only categories that belong to a specific parent category |
| `title__icontains` | string | No | Filter by category title (case-insensitive). Use this to search for categories containing specific text in their title |
| `parent__title__icontains` | string | No | Filter by parent category title (case-insensitive). Use this to find categories whose parent's title contains specific text |

#### 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 Gifts

**Slug:** `AMCARDS_LIST_GIFTS`

Tool to retrieve a list of Gift items offered by AMcards. Use when you need to display or reference available gifts for selection or purchase. No authorization required.

#### 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 Public Templates

**Slug:** `AMCARDS_LIST_PUBLIC_TEMPLATES`

Tool to retrieve a list of public templates available to all users. Use when you need to browse or search available card templates. No authorization required for this endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category__id` | integer | No | Filter by category ID to retrieve templates from a specific category |
| `name__icontains` | string | No | Filter by template name (case-insensitive partial match). Use this to search for templates containing specific text in their name |

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