PostCo and armincx: Connection and Queries
The armincx PostCo integration gives your AI agent read access to your returns in PostCo: it answers whether a return has arrived, where the return shipment is and whether the refund has gone through. The integration is read-only, and no query needs approval.
You need an API key from your PostCo merchant account. You create it in PostCo under Account Settings, Manage API Keys, for example with the name "Chatarmin CX". PostCo shows the key only once, and each key only reads the returns of its own shop.
Under Integrations, select PostCo and paste the key. armincx checks it with PostCo and stores it encrypted. Then activate the PostCo actions for your AI agents and choose the connected account.
| Query | What it's for |
|---|
| Get return | find a return by order number or PostCo return ID |
| Find returns by email | find a customer's returns via their email address |
| Get return shipment | status, carrier, tracking number, shipping fee and who pays |
| Check existing returns | see whether an order already has a return and what it contains |
Searches return up to 25 returns, newest first. If there are more, the agent knows the list is incomplete and doesn't present it as complete.
You'll find the step-by-step guide in our documentation.