--- title: "Connect Holded to Cnpja - APIANT.ai" description: "When \"New Contact\" fires in Holded, your agent runs \"Add list\" in Cnpja. Describe the whole flow and it is built, tested on every scenario and kept running." canonical: "https://apiant.ai/connect/holded-to-cnpja" --- # Connect Holded to Cnpja When **New Contact** fires in [Holded](https://apiant.ai/connections/holded), your agent runs **Add list** in [Cnpja](https://apiant.ai/connections/cnpja). Describe the whole flow and it is built, tested on every scenario and kept running. Holded **6** triggers Holded **12** actions Cnpja **12** actions What the catalog holds today. Ask for anything missing and your agent reads the API documentation and adds it. ## What do you want Holded and Cnpja to do together? Give your AI client this address. `https://mcp.apiant.ai` One connection does both: ask your client to act in an app once, or have it build an automation that keeps running. Any client that takes a remote MCP server. Nothing to install. Create your free account, then sign in once in your browser. ### Set it up in your client ### Claude Code Run this in the directory you want to work in. `claude mcp add --transport http -s project apiant-ai https://mcp.apiant.ai` Start Claude Code there, approve the server, and sign in in the browser page it opens. [Claude Code guide (opens in a new tab)](https://apiant.ai/docs/mcp/claude-code) ### Claude, web and desktop Open Customize, then Connectors, then Add custom connector, and paste the address. On Team and Enterprise an owner adds it first. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Cursor Add the address to your MCP configuration as a server URL. Cursor signs you in in your browser. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Zed Open Settings, then AI, then MCP Servers, then Add Server, then Add Remote Server. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Codex and the ChatGPT desktop app Open Settings, then MCP servers, then Add server, and choose Streamable HTTP. From the terminal, Codex takes the address with its own add command and then signs you in. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Any other MCP client Paste the address where the client asks for a remote MCP server URL, and name the server apiant-ai where it lets you. APIANT's skills reach the client over the same connection. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) Example flows ## What Holded can start in Cnpja - When **New Contact** in Holded then **Add list** in Cnpja - When **New Deal** in Holded then **Update list** in Cnpja Starting points drawn from the triggers and actions in the catalog today. Describe the flow you need, at any depth, and your agent builds it and tests every scenario before it ships. Everything your agent can do with Holded and Cnpja ## Triggers and actions 6 triggers · 24 actions - Trigger **New Contact** Triggers when a new contact is created in Holded. - Trigger **New Deal** Triggers when a new deal (lead) is created in a Holded CRM funnel. - Trigger **New Purchase Invoice** Triggers when a new purchase invoice is created in Holded. - Trigger **New Sales Invoice** Triggers when a new sales invoice is created in Holded. - Trigger **New Sales Order** Triggers when a new sales order is created in Holded. - Trigger **New Sales Receipt** Triggers when a new sales receipt is created in Holded. - Action **Create Payment** Records a standalone payment in Holded. - Action **Create Product** Creates a product in Holded. - Action **Create Purchase Invoice** Creates a purchase invoice in Holded with its line items. - Action **Create Purchase Order** Creates a purchase order in Holded with its line items. - Action **Create Quote** Creates a quote (estimate) in Holded with its line items. - Action **Create Sales Invoice** Creates a sales invoice in Holded with its line items. - Action **Create Sales Order** Creates a sales order in Holded with its line items. - Action **Create Sales Receipt** Creates a sales receipt in Holded with its line items. - Action **Find Contact** Finds Holded contacts by phone, mobile or custom reference ID. - Action **Mark Credit Note as Paid** Records a payment on a credit note, marking it paid. - Action **Send Invoice** Emails a sales invoice to the given addresses. - Action **Send Sales Receipt** Emails a sales receipt to the given addresses. - Action **Add list** Creates a new list of Brazilian companies (CNPJs) in your CNPJá account, either from a set of CNPJ numbers or from search filters. - Action **Delete list** Deletes a CNPJ list by its ID. - Action **Find offices by criteria** Returns Brazilian business establishments (CNPJs) that match the search criteria you set, such as name, location, activity, status or contact details. - Action **Get company** Returns a Brazilian company's registration data, including its partners (members) and all of its offices. - Action **Get credit balance** Returns the number of credits remaining in your CNPJá account, split into carried-over and current-month credits. - Action **Get list** Returns a CNPJ list by its id, including its title, description, size, CNPJ numbers and the search filters used to build it. - Action **Get office** Returns the full registration details of a Brazilian establishment (office) by its CNPJ, including company, address, contacts, activities and optional Simples, state registration and SUFRAMA data. - Action **Get person** Returns a person's details, including every company partnership they belong to. - Action **Get Simples Nacional status** Returns a company's Simples Nacional and MEI status, including inclusion dates and optional history of past periods. - Action **Get zip code** Returns the address details for a Brazilian postal code (CEP), including street, district, city, state and IBGE municipality code. - Action **List lists** Returns the company (CNPJ) lists in your CNPJá account, optionally filtered by a search term in the title or description. - Action **Update list** Updates the title, description or CNPJ items of an existing CNPJ list and returns the updated list. ## Each app on its own - [ **Holded** The cloud-based tool that has everything you need to manage your company — wherever you are, whenever you...](https://apiant.ai/connections/holded) - [ **Cnpja** API for real-time lookup of Brazilian CNPJ company registration data, including tax status, address, and...](https://apiant.ai/connections/cnpja) Reviews ## What our customers say ## More from Holded - [ **Holded to HubSpot** HubSpot is your all-in-one stop for all of your marketing software needs.](https://apiant.ai/connect/holded-to-hubspot) - [ **Holded to Salesforce** Salesforce is a leading enterprise customer relationship management (CRM) platform.](https://apiant.ai/connect/holded-to-salesforce) - [ **Holded to Slack** Slack is a messaging platform for teams. Post messages, manage channels, users, reminders, and react to...](https://apiant.ai/connect/holded-to-slack) - [ **Holded to Mailchimp** Mailchimp marketing automation and email platform.](https://apiant.ai/connect/holded-to-mailchimp) - [ **Holded to Stripe** Stripe is a payment processing platform for online businesses.](https://apiant.ai/connect/holded-to-stripe) - [ **Holded to Shopify** Shopify is a commerce platform for online stores and retail point-of-sale.](https://apiant.ai/connect/holded-to-shopify) ## More into Cnpja - [ **HubSpot to Cnpja** HubSpot is your all-in-one stop for all of your marketing software needs.](https://apiant.ai/connect/hubspot-to-cnpja) - [ **Salesforce to Cnpja** Salesforce is a leading enterprise customer relationship management (CRM) platform.](https://apiant.ai/connect/salesforce-to-cnpja) - [ **Slack to Cnpja** Slack is a messaging platform for teams. Post messages, manage channels, users, reminders, and react to...](https://apiant.ai/connect/slack-to-cnpja) - [ **Google Sheets to Cnpja** Google Sheets is Google's online spreadsheet app for creating, editing and sharing spreadsheets.](https://apiant.ai/connect/google-sheets-to-cnpja) - [ **Gmail to Cnpja** Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with...](https://apiant.ai/connect/gmail-to-cnpja) - [ **Google Calendar to Cnpja** Google Calendar is a time management tool providing scheduling features, event reminders, and integration...](https://apiant.ai/connect/google-calendar-to-cnpja) Questions ## Holded and Cnpja, answered ### ### What can start an automation from Holded? Any of Holded's 6 triggers in the catalog, including New Contact, New Deal, New Purchase Invoice and New Sales Invoice. Describe the moment in plain language and your agent picks the right one. ### ### What can your agent do in Cnpja when something happens in Holded? Any of Cnpja's 12 actions, including Update list, Add list, Find offices by criteria and Get company. Your agent maps the data both ways and tests every scenario before it ships. ### ### Can it also run from Cnpja to Holded? Cnpja has no triggers in the catalog today, so automations start in Holded. If you need the other direction, ask: your agent reads Cnpja's API documentation and adds it. ### ### Do I have to build a connector for Holded or Cnpja? No. Both are in the catalog with their triggers and actions. You describe the automation; your agent builds it, tests every scenario and keeps it running. ### ### Can my AI client use Holded and Cnpja without building an automation? Yes. With your AI client connected to APIANT, ask it to do something in either app once and it runs that action on the spot. Ask for an automation and your agent builds it, tests every scenario and keeps it running. One connection covers both. ### ### What happens when something fails? Your agent works that out for you. It plans the failure paths along with the happy path, then tests every scenario before it ships. ### ### Is there a free plan? Yes. Every plan includes the agent, including free, and building from your own AI client spends no assistant credits.