# Embat Contacts API

**Canonical:** https://apis.io/apis/embat/embat-contacts-api/  
**Provider:** Embat — https://apis.io/providers/embat/  
**Base URL:** https://api.embat.io  
**Documentation:** https://api.embat.io/docs

Embat Contacts API is one of 22 APIs that [Embat](https://apis.io/providers/embat/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Contacts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

`Contact` represents a client or supplier your company transacts with. `customId` is the unique identifier of a contact: set your own value to use as your ERP contact ID, or let Embat auto-generate one. A contact is referenced from other entities to identify who is involved in a transaction: `Operations` (invoices/bills) are billed to or from a contact, `Payments` can record a collection or payment made to a contact, and `AccountingEntries` can be linked to a contact for reconciliation. A contact also carries the bank account details (`accounts`, `paymentsAccounts`) Embat uses to execute payments to it. **Typical flow:** contacts are usually kept in sync from your ERP, since they are the master data referenced when creating operations and payments. 1. **Create or update a contact from your ERP.** Whenever a client or supplier is created or edited in your ERP, upsert it in Embat with its identification and, if relevant, bank account details: ```json POST /contacts/{companyId} { "customId": "erp-contact-001", "legalName": "Acme Supplies S.L.", "taxId": "B12345678", "type": "supplier", "paymentsAccounts": [ { "currency": "EUR", "default": true, "details": { "iban": "ES9121000418450200051332" } } ] } ``` 2. **Reference the contact by `customId`.** Use the same `customId` in `Operations` and `Payments` to link them to this contact. 3. **Keep it up to date.** Sending `POST /contacts/{companyId}` again with the same `customId` updates the existing contact instead of creating a duplicate; use `PATCH /contacts/{companyId}/{customId}` (or the bulk variant) to update specific fields only.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/embat/refs/heads/main/openapi/embat-contacts-api-openapi.yml
- **Documentation** — https://api.embat.io/docs
- **APIReference** — https://api.embat.io/docs

## Other Embat APIs (12)

- [Embat AccountingAccounts API](https://apis.io/apis/embat/embat-accountingaccounts-api/)
- [Embat AccountingEntries API](https://apis.io/apis/embat/embat-accountingentries-api/)
- [Embat Attributes API](https://apis.io/apis/embat/embat-attributes-api/)
- [Embat Authentication API](https://apis.io/apis/embat/embat-authentication-api/)
- [Embat Balances API](https://apis.io/apis/embat/embat-balances-api/)
- [Embat Banks API](https://apis.io/apis/embat/embat-banks-api/)
- [Embat Categories API](https://apis.io/apis/embat/embat-categories-api/)
- [Embat Companies API](https://apis.io/apis/embat/embat-companies-api/)
- [Embat DebtScheduleConfigs API](https://apis.io/apis/embat/embat-debtscheduleconfigs-api/)
- [Embat Files API](https://apis.io/apis/embat/embat-files-api/)
- [Embat Forecasts API](https://apis.io/apis/embat/embat-forecasts-api/)
- [Embat ForeignExchangeRates API](https://apis.io/apis/embat/embat-foreignexchangerates-api/)

## Tags

Contacts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/embat/embat-contacts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/embat/.