Mailing Services

Intelliprint

Learn how to use Intelliprint with Composio

Overview

SLUG: INTELLIPRINT

Description

Intelliprint offers a Hybrid Mail API that enables businesses to automate their letter printing and mailing processes, providing features like same-day printing, secure authentication, and real-time tracking.

Authentication Details

generic_api_key
stringRequired

Connecting to Intelliprint

Create an auth config

Use the dashboard to create an auth config for the Intelliprint toolkit. This allows you to connect multiple Intelliprint accounts to Composio for agents to use.

1

Select App

Navigate to Intelliprint.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Intelliprint Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4intelliprint_auth_config_id = "ac_YOUR_INTELLIPRINT_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Intelliprint for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, intelliprint_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Intelliprint toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["INTELLIPRINT"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Cancel or Delete Print Job

Description

Tool to delete or cancel an existing Print Job by its ID. Use after confirming the print job ID to remove or refund a job.

Action Parameters

print_ID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create background

Description

Tool to create a new Background. Use when you have a background file (and optional name or team) to upload.

Action Parameters

file
stringRequired
file_path
string
name
string
team
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Print Job

Description

Tool to create a new print job. Use when a document is ready to submit (optionally confirming immediately).

Action Parameters

confirmed
boolean
file
stringRequired
reference
string
testmode
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Backgrounds

Description

Tool to list backgrounds with optional filtering and pagination. Use after uploading or managing backgrounds to retrieve current entries. Example: 'List backgrounds for team=team_1234 with limit=50 and skip=10'.

Action Parameters

limit
integerDefaults to 10
skip
integer
team
string

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringRequired
successful
booleanRequired
total_available
integerRequired

Tool Name: List Print Jobs

Description

Tool to list print jobs with optional filters and pagination. Use after confirming API key.

Action Parameters

confirmed
boolean
letters.status
string
limit
integerDefaults to 10
skip
integer
testmode
boolean

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringRequired
successful
booleanRequired
total_available
integerRequired

Tool Name: List Templates

Description

Tool to list all available templates. Use after authenticating API key to browse available templates.

Action Parameters

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringRequired
successful
booleanRequired
total_available
integerRequired

Tool Name: Merge Files

Description

Tool to merge multiple files into one document. Use when you need a single merged document from separate files.

Action Parameters

files
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve Background

Description

Tool to retrieve a specific Background by ID. Use when you need background details before further processing.

Action Parameters

background_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve Print Job

Description

Tool to retrieve details of a Print Job by its ID. Use when you have a valid print_id and need full job specifications.

Action Parameters

print_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Background

Description

Tool to update an existing Background's name or team. Use when you need to change a background after creation. Example: 'Update background bg_123abc to new name'.

Action Parameters

background_id
stringRequired
name
string
team
string

Action Response

data
objectRequired
error
string
successful
booleanRequired