Contacts

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean

GET/{administration_id}/contacts/customer_id/{customer_id}{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/customer_id/:customer_id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "499054008976017394",
  "administration_id": 123,
  "company_name": "Foobar Holding B.V.",
  "firstname": null,
  "lastname": "Appleseed",
  "address1": "Hoofdstraat 12",
  "address2": "",
  "zipcode": "1234 AB",
  "city": "Amsterdam",
  "country": "NL",
  "phone": "",
  "delivery_method": "Email",
  "customer_id": "1",
  "tax_number": "",
  "chamber_of_commerce": "",
  "bank_account": "",
  "is_trusted": false,
  "max_transfer_amount": null,
  "attention": "",
  "email": "info@example.com",
  "email_ubl": true,
  "send_invoices_to_attention": "",
  "send_invoices_to_email": "info@example.com",
  "send_estimates_to_attention": "",
  "send_estimates_to_email": "info@example.com",
  "direct_debit": false,
  "sepa_active": false,
  "sepa_iban": "",
  "sepa_iban_account_name": "",
  "sepa_bic": "",
  "sepa_mandate_id": "",
  "sepa_mandate_date": null,
  "sepa_sequence_type": "RCUR",
  "credit_card_number": "",
  "credit_card_reference": "",
  "credit_card_type": null,
  "tax_number_validated_at": null,
  "tax_number_valid": null,
  "invoice_workflow_id": null,
  "estimate_workflow_id": null,
  "si_identifier": "",
  "si_identifier_type": null,
  "moneybird_payments_mandate": false,
  "created_at": "2026-09-23T09:16:52.579Z",
  "updated_at": "2026-09-23T09:16:52.609Z",
  "version": 1790155012,
  "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/1a1228351c09b5589fe72a57d2d4cde6ebb3559516b836caeac01e60b71778f1/all",
  "notes": [],
  "custom_fields": [],
  "contact_people": [
    {
      "id": "499054008982308852",
      "contact_id": "499054008976017394",
      "administration_id": 123,
      "firstname": "John",
      "lastname": "Appleseed",
      "phone": null,
      "email": null,
      "department": null,
      "created_at": "2026-09-23T09:16:52.586Z",
      "updated_at": "2026-09-23T09:16:52.586Z",
      "version": 1790155012
    }
  ],
  "archived": false,
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "contact_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:16:52.598Z",
      "updated_at": "2026-09-23T09:16:52.598Z"
    }
  ]
}

json

application/json

List possible duplicate contacts

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/doubles{format}

Returns groups of contacts in the administration that are considered possible duplicates of each other.

Pages are sized by the total number of contacts across the groups they contain, not by the number of groups. A group is never split across two pages, so a page can contain more contacts than the target page size when the group that fills it up is larger than that.

Only available once this feature has been enabled for the administration.

Required scope(s)

contacts

List possible duplicate contacts › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List possible duplicate contacts › query Parameters

page

integer | string

List possible duplicate contacts › Responses

A page of possible duplicate contact groups

object[]

simple_contact_response[]

Filter contacts

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/filter{format}

Returns a paginated list of all contacts in the administration.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Filter contacts › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Filter contacts › query Parameters

filter

string

Filters are key:value terms separated by commas (e.g. first_name:henk,contact_type:company). Any filter you pass replaces the defaults below entirely, so include every key you need. Available filters:

Filter	Type	Description
created_after	`String`	Select contacts created after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone
updated_after	`String`	Select contacts updated after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone
first_name	`String`	Select contacts with the given first name. Case-insensitive
last_name	`String`	Select contacts with the given last name. Case-insensitive
estimate_workflow_id	`Integer`	Filters contacts by a single Estimate workflow
invoice_workflow_id	`Integer`	Filters contacts by a single Invoice workflow
contact_type	`String`	The contact type. Possible values `all`, `company`, `private_individual`
delivery_method	`String`	The delivery method for invoices. Possible values. Possible values `all`, `email`, `post`, `manual`, `peppol`, `simplerinvoicing`
trusted_type	`String`	Whether the contact is trusted. Possible values `all`, `trusted`, `not_trusted`
mandate_type	`String`	The direct debit mandate of the contact. Possible values `all`, `manual` (the SEPA mandate fields are filled in), `adyen` (an accepted Moneybird mandate), `none` (no mandate at all)

query

string

Free-text search across name, contact people, email, phone, customer id, tax number, chamber of commerce, IBAN, and address fields.

include_archived

boolean | string

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Filter contacts › Responses

200

A list of contacts

contact_response[]

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean

GET/{administration_id}/contacts/filter{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/filter:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "499054008618452910",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": null,
    "lastname": "Appleseed",
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234 AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "1",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "sepa_active": false,
    "sepa_iban": "",
    "sepa_iban_account_name": "",
    "sepa_bic": "",
    "sepa_mandate_id": "",
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-09-23T09:16:52.239Z",
    "updated_at": "2026-09-23T09:16:52.254Z",
    "version": 1790155012,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/394d036dcd3bdb5715db15fc69cd11cc691a0f02ed88b8d021e5e312550f141c/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "499054008621598640",
        "contact_id": "499054008618452910",
        "administration_id": 123,
        "firstname": "John",
        "lastname": "Appleseed",
        "phone": null,
        "email": null,
        "department": null,
        "created_at": "2026-09-23T09:16:52.242Z",
        "updated_at": "2026-09-23T09:16:52.242Z",
        "version": 1790155012
      }
    ],
    "archived": false,
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "contact_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:16:52.248Z",
        "updated_at": "2026-09-23T09:16:52.248Z"
      }
    ]
  },
  {
    "id": "499054008641521589",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": null,
    "lastname": null,
    "address1": "1 Infinite Loop",
    "address2": "",
    "zipcode": "123456",
    "city": "Redmond",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "2",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "NL50TEST0166567191",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "sepa_active": true,
    "sepa_iban": "NL50TEST0166567191",
    "sepa_iban_account_name": "Foobar Holding B.V.",
    "sepa_bic": "RABONL2U",
    "sepa_mandate_id": "MAN12313",
    "sepa_mandate_date": "2014-01-01",
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-09-23T09:16:52.261Z",
    "updated_at": "2026-09-23T09:16:52.261Z",
    "version": 1790155012,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/20230b6d8f99754ed0698456949dc335d7948077271d57c955c3c970ef8a866b/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "499054008644667319",
        "contact_id": "499054008641521589",
        "administration_id": 123,
        "firstname": "John",
        "lastname": "Doe",
        "phone": null,
        "email": null,
        "department": null,
        "created_at": "2026-09-23T09:16:52.264Z",
        "updated_at": "2026-09-23T09:16:52.264Z",
        "version": 1790155012
      }
    ],
    "archived": false,
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "contact_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:16:52.270Z",
        "updated_at": "2026-09-23T09:16:52.270Z"
      }
    ]
  },
  {
    "id": "499054008656201659",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": null,
    "lastname": null,
    "address1": "Hoofdstraat 12",
    "address2": null,
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": null,
    "delivery_method": "Email",
    "customer_id": "customer-1",
    "tax_number": null,
    "chamber_of_commerce": null,
    "bank_account": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "sepa_active": false,
    "sepa_iban": null,
    "sepa_iban_account_name": null,
    "sepa_bic": null,
    "sepa_mandate_id": null,
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": null,
    "credit_card_reference": null,
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": null,
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-09-23T09:16:52.276Z",
    "updated_at": "2026-09-23T09:16:52.276Z",
    "version": 1790155012,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false,
    "events": []
  }
]

json

application/json

List all ids and versions

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/synchronization{format}

Returns all contacts in the administration. The list contains the contact id and the version of the contact. Check if the version of the contact is newer than the version you have stored locally, use the POST variant for fetching contacts with the given ids.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

List all ids and versions › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all ids and versions › query Parameters

filter

string

Comma-separated key:value filter terms. Same syntax as GET /contacts/filter — see that operation's description for the available keys.

include_archived

boolean | string

List all ids and versions › Responses

200

IDs and versions of records

object[]

id

integer | string

version

integer | string

Fetch contacts with given ids

POST

https://moneybird.com/api/v2

/{administration_id}/contacts/synchronization{format}

Given a list of contact ids, returns the contact information belonging to the contacts. Returns a maximum of 100 contacts, even if more ids are provided.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Fetch contacts with given ids › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Fetch contacts with given ids › Request Body

ids

(integer | string)[] · required

Fetch contacts with given ids › Responses

A list of contacts

contact_response[]

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean

recurring_contract_response

POST/{administration_id}/contacts/synchronization{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/synchronization:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "ids": [
    499054012108113400,
    499054012130133500
  ]
}'

Example Request Body

{
  "ids": [
    499054012108113400,
    499054012130133500
  ]
}

json

application/json

Example Responses

[
  {
    "id": "499054012108113419",
    "administration_id": 123,
    "company_name": "Bar Foo",
    "firstname": null,
    "lastname": null,
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "3",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "sepa_active": false,
    "sepa_iban": "",
    "sepa_iban_account_name": "",
    "sepa_bic": "",
    "sepa_mandate_id": "",
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-09-23T09:16:55.567Z",
    "updated_at": "2026-09-23T09:16:55.567Z",
    "version": 1790155015,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/d5d76a2f20d18414c6b783bca26ff2fec3edababa30c0f6fed9b4700ce5e1eec/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "499054012111259149",
        "contact_id": "499054012108113419",
        "administration_id": 123,
        "firstname": "John",
        "lastname": "Appleseed",
        "phone": null,
        "email": null,
        "department": null,
        "created_at": "2026-09-23T09:16:55.571Z",
        "updated_at": "2026-09-23T09:16:55.571Z",
        "version": 1790155015
      }
    ],
    "archived": false,
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "contact_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:16:55.576Z",
        "updated_at": "2026-09-23T09:16:55.576Z"
      }
    ]
  },
  {
    "id": "499054012130133523",
    "administration_id": 123,
    "company_name": "Foo Bar",
    "firstname": null,
    "lastname": null,
    "address1": "Hoofdstraat 12",
    "address2": "",
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "4",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "sepa_active": false,
    "sepa_iban": "",
    "sepa_iban_account_name": "",
    "sepa_bic": "",
    "sepa_mandate_id": "",
    "sepa_mandate_date": null,
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-09-23T09:16:55.588Z",
    "updated_at": "2026-09-23T09:16:55.588Z",
    "version": 1790155015,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/cc4c5e7c00befff02383e9af43755c0ede1478121a4f2153451914d75106a5ec/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "499054012133279253",
        "contact_id": "499054012130133523",
        "administration_id": 123,
        "firstname": "Mark",
        "lastname": "van Vliet",
        "phone": null,
        "email": null,
        "department": null,
        "created_at": "2026-09-23T09:16:55.591Z",
        "updated_at": "2026-09-23T09:16:55.591Z",
        "version": 1790155015
      }
    ],
    "archived": false,
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "contact_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:16:55.597Z",
        "updated_at": "2026-09-23T09:16:55.597Z"
      }
    ]
  }
]

json

application/json

Get contact person

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/contact_people/{id}{format}

Returns all information about a contact person.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Get contact person › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get contact person › Responses

A contact person

contact_person_response

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

firstname

string | null

lastname

string | null

phone

string | null

email

string | null

department

string | null

created_at

string | null · date-time

updated_at

string | null · date-time

version

integer

Delete a contact person

DELETE

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/contact_people/{id}{format}

Deletes a contact person.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Delete a contact person › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete a contact person › Responses

Contact person deleted

No data returned

Update a contact person

PATCH

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/contact_people/{id}{format}

When updating a contact, you only need to provide the information you want to change. Attributes you don't provide in the request will not be updated.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Update a contact person › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Update a contact person › Request Body

object

Update a contact person › Responses

Contact person updated

contact_person_response

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

firstname

string | null

lastname

string | null

phone

string | null

email

string | null

department

string | null

created_at

string | null · date-time

updated_at

string | null · date-time

version

integer

PATCH/{administration_id}/contacts/{contact_id}/contact_people/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:contact_id/contact_people/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "contact_person": {
    "firstname": "John",
    "lastname": "Doe"
  }
}'

Example Request Body

{
  "contact_person": {
    "firstname": "John",
    "lastname": "Doe"
  }
}

json

application/json

Example Responses

{
  "id": "499054018283177290",
  "contact_id": "499054018277934408",
  "administration_id": 123,
  "firstname": "John",
  "lastname": "Doe",
  "phone": null,
  "email": null,
  "department": null,
  "created_at": "2026-09-23T09:17:01.456Z",
  "updated_at": "2026-09-23T09:17:01.499Z",
  "version": 1790155021
}

json

application/json

Create a new contact person

POST

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/contact_people{format}

Creating a new contact person in the administration requires at least a contact_person hash including firstname and lastname.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Create a new contact person › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create a new contact person › Request Body

object

Create a new contact person › Responses

Contact person created

contact_person_response

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

firstname

string | null

lastname

string | null

phone

string | null

email

string | null

department

string | null

created_at

string | null · date-time

updated_at

string | null · date-time

version

integer

POST/{administration_id}/contacts/{contact_id}/contact_people{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:contact_id/contact_people:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "contact_person": {
    "firstname": "John",
    "lastname": "Doe"
  }
}'

Example Request Body

{
  "contact_person": {
    "firstname": "John",
    "lastname": "Doe"
  }
}

json

application/json

Example Responses

{
  "id": "499054017081508946",
  "contact_id": "499054017035371589",
  "administration_id": 123,
  "firstname": "John",
  "lastname": "Doe",
  "phone": null,
  "email": null,
  "department": null,
  "created_at": "2026-09-23T09:17:00.310Z",
  "updated_at": "2026-09-23T09:17:00.310Z",
  "version": 1790155020
}

json

application/json

Request an URL for setting up a Moneybird Payments mandate

POST

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/moneybird_payments_mandate/url{format}

Obtains an URL for setting up a Moneybird Payments mandate. You must provide this URL to your contact to set-up the mandate. Your contact is required to make a 15 cent payment. Every generated URL using this endpoint is valid for 14 days after creation. Only available when Moneybird Payments is enabled for the administration.

Required scope(s)

sales_invoices and settings

Request an URL for setting up a Moneybird Payments mandate › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Request an URL for setting up a Moneybird Payments mandate › Request Body

object

Request an URL for setting up a Moneybird Payments mandate › Responses

A URL for setting up a Moneybird Payments mandate

url

string

POST/{administration_id}/contacts/{contact_id}/moneybird_payments_mandate/url{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:contact_id/moneybird_payments_mandate/url:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Example Request Body

{}

json

application/json

Example Responses

{
  "url": "https://moneybird.dev/123/mandate_requests/zICBpl9yYWlsc4KkZGF0YdlFNDk5MDUzNzkzMzc2MjA3OTczIDQ5OTA1NDAwOTgzNTg0ODc3NiA0OTkwNTM3OTM4MTAzMTg0NDMKICAgICAgYWR5ZW4go2V4cMcLB85qxg4FziJmongA--b205f1b77fc20b2d8550384b7061a81c877c54fd"
}

json

application/json

Get Moneybird Payments mandate

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/moneybird_payments_mandate{format}

Returns information about the stored Moneybird Payments mandate. Only available when Moneybird Payments is enabled for the administration.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Get Moneybird Payments mandate › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get Moneybird Payments mandate › Responses

A Moneybird Payments mandate

type

string | null

sepa_mandate

boolean

bank

string | null

iban

string | null

bic

string | null

iban_account_name

string | null

card_expiry_month

string | null

card_expiry_year

string | null

card_final_digits

string | null

created_at

timestamp · date-time

Request a new Moneybird Payments mandate

POST

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/moneybird_payments_mandate{format}

Sends a request for a Moneybird Payments mandate to a contact via e-mail. Your contact will receive an email containing a link to authorise direct debit payments through Moneybird Payments. Your contact is required to make a 15 cent payment. Only available when Moneybird Payments is enabled for the administration.

Required scope(s)

sales_invoices and settings

Request a new Moneybird Payments mandate › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Request a new Moneybird Payments mandate › Request Body

object

Request a new Moneybird Payments mandate › Responses

Moneybird Payments mandate requested

No data returned

POST/{administration_id}/contacts/{contact_id}/moneybird_payments_mandate{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:contact_id/moneybird_payments_mandate:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "mandate_request": {
    "email_message": "We use direct debit for our services, for which we require your authorisation. You can authorise us for direct debit through the button below. This requires you to make a one-time payment of 15 cents. This way we can verify your bank account."
  }
}'

Example Request Body

{
  "mandate_request": {
    "email_message": "We use direct debit for our services, for which we require your authorisation. You can authorise us for direct debit through the button below. This requires you to make a one-time payment of 15 cents. This way we can verify your bank account."
  }
}

json

application/json

Example Responses

No example specified for this content type

Delete a stored Moneybird Payments mandate

DELETE

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/moneybird_payments_mandate{format}

Deletes the stored Moneybird Payments mandate for the contact. Only available when Moneybird Payments is enabled for the administration.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Delete a stored Moneybird Payments mandate › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete a stored Moneybird Payments mandate › Responses

Contact deleted

No data returned

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/notes/{id}{format}

Deletes a note from the contact.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Destroys note from entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Destroys note from entity › Responses

Note deleted

No data returned

Adds note to entity

POST

https://moneybird.com/api/v2

/{administration_id}/contacts/{contact_id}/notes{format}

Adds a note to the contact.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Adds note to entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

contact_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Adds note to entity › Request Body

object

Adds note to entity › Responses

Note created

note_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

entity_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

identifier · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo_type

string | null · enum

Enum values:

sales_invoice_due

purchase_invoice_due

general_document_reminder

general_document_due

new_document_awaiting_processing

new_financial_mutation_awaiting_processing

financial_mutations_not_updated

sales_invoice_payment_not_linked_to_financial_mutation

data

object | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/contacts/{contact_id}/notes{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:contact_id/notes:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "note": {
    "note": "Text of the note",
    "assignee_id": 499054012355577400,
    "todo": true
  }
}'

Example Request Body

{
  "note": {
    "note": "Text of the note",
    "assignee_id": 499054012355577400,
    "todo": true
  }
}

json

application/json

Example Responses

{
  "id": "499054012371306054",
  "administration_id": 123,
  "entity_id": "499054012315731512",
  "entity_type": "Contact",
  "user_id": "499053793376207973",
  "assignee_id": "499054012355577412",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-09-23T09:16:55.819Z",
  "updated_at": "2026-09-23T09:16:55.819Z"
}

json

application/json

Get additional charges

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/{id}/additional_charges{format}

Get the additional charges of the given contact.

Required scope(s)

sales_invoices

Get additional charges › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get additional charges › query Parameters

include_billed

boolean | string

If true, includes the additional charges that have already been billed. Default is false.

Get additional charges › Responses

A list of additional charges

subscription_additional_charge_response[]

subscription_additional_charge_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

subscription_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

product_id

identifier · pattern: ^\d+$

A unique record identifier

detail_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

amount

string | null

price

string

period

string · pattern: ^[0-9]{6}..[0-9]{6}$

description

string

GET/{administration_id}/contacts/{id}/additional_charges{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:id/additional_charges:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "499054017568048319",
    "administration_id": 123,
    "contact_id": "499054017528202418",
    "subscription_id": null,
    "product_id": "499054017565951166",
    "detail_id": null,
    "amount": "1 x",
    "price": "100.0",
    "period": "202106..202106",
    "description": "Transaction Costs"
  },
  {
    "id": "499054017609991367",
    "administration_id": 123,
    "contact_id": "499054017528202418",
    "subscription_id": null,
    "product_id": "499054017572242624",
    "detail_id": "499054017606845638",
    "amount": "1 x",
    "price": "100.0",
    "period": "202106..202106",
    "description": "Transaction Costs"
  }
]

json

application/json

Create an additional charge to be invoiced at start of next period

POST

https://moneybird.com/api/v2

/{administration_id}/contacts/{id}/additional_charges{format}

At the end of the current period, the additional charges for a contact are merged where possible and an invoice will be created for them. The invoice will be scheduled for sending at the first day of the next month.

Required scope(s)

sales_invoices

Create an additional charge to be invoiced at start of next period › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create an additional charge to be invoiced at start of next period › Request Body

Create an additional charge to be invoiced at start of next period › Responses

Subscription additional charge created

subscription_additional_charge_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

subscription_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

product_id

identifier · pattern: ^\d+$

A unique record identifier

detail_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

amount

string | null

price

string

period

string · pattern: ^[0-9]{6}..[0-9]{6}$

description

string

POST/{administration_id}/contacts/{id}/additional_charges{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:id/additional_charges:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "product_id": 499054010913785100,
  "amount": "5 x",
  "price": 100,
  "period": "20210601..20210630",
  "description": "Transaction Costs"
}'

Example Request Body

{
  "product_id": 499054010913785100,
  "amount": "5 x",
  "price": 100,
  "period": "20210601..20210630",
  "description": "Transaction Costs"
}

json

application/json

Example Responses

{
  "id": "499054010928465170",
  "administration_id": 123,
  "contact_id": "499054010868696324",
  "subscription_id": null,
  "product_id": "499054010913785104",
  "detail_id": null,
  "amount": "5 x",
  "price": "100.0",
  "period": "202106..202106",
  "description": "Transaction Costs"
}

json

application/json

Archive a contact

PATCH

https://moneybird.com/api/v2

/{administration_id}/contacts/{id}/archive{format}

Archives a contact.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Archive a contact › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Archive a contact › Responses

Contact archived

No data returned

Get contact

GET

https://moneybird.com/api/v2

/{administration_id}/contacts/{id}{format}

Returns all information about a contact.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Get contact › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get contact › query Parameters

include_archived

boolean | string

Get contact › Responses

A contact

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean

GET/{administration_id}/contacts/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "499054018432075110",
  "administration_id": 123,
  "company_name": "Foobar Holding B.V.",
  "firstname": null,
  "lastname": "Appleseed",
  "address1": "Hoofdstraat 12",
  "address2": "",
  "zipcode": "1234 AB",
  "city": "Amsterdam",
  "country": "NL",
  "phone": "",
  "delivery_method": "Email",
  "customer_id": "1",
  "tax_number": "",
  "chamber_of_commerce": "",
  "bank_account": "",
  "is_trusted": false,
  "max_transfer_amount": null,
  "attention": "",
  "email": "info@example.com",
  "email_ubl": true,
  "send_invoices_to_attention": "",
  "send_invoices_to_email": "info@example.com",
  "send_estimates_to_attention": "",
  "send_estimates_to_email": "info@example.com",
  "direct_debit": false,
  "sepa_active": false,
  "sepa_iban": "",
  "sepa_iban_account_name": "",
  "sepa_bic": "",
  "sepa_mandate_id": "",
  "sepa_mandate_date": null,
  "sepa_sequence_type": "RCUR",
  "credit_card_number": "",
  "credit_card_reference": "",
  "credit_card_type": null,
  "tax_number_validated_at": null,
  "tax_number_valid": null,
  "invoice_workflow_id": null,
  "estimate_workflow_id": null,
  "si_identifier": "",
  "si_identifier_type": null,
  "moneybird_payments_mandate": false,
  "created_at": "2026-09-23T09:17:01.598Z",
  "updated_at": "2026-09-23T09:17:01.615Z",
  "version": 1790155021,
  "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/9b1da255cd727553967f04d70bd39c3a743648123f176dce6ee3edb515ef0ffb/all",
  "notes": [],
  "custom_fields": [],
  "contact_people": [
    {
      "id": "499054018436269416",
      "contact_id": "499054018432075110",
      "administration_id": 123,
      "firstname": "John",
      "lastname": "Appleseed",
      "phone": null,
      "email": null,
      "department": null,
      "created_at": "2026-09-23T09:17:01.602Z",
      "updated_at": "2026-09-23T09:17:01.602Z",
      "version": 1790155021
    }
  ],
  "archived": false,
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "contact_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:17:01.609Z",
      "updated_at": "2026-09-23T09:17:01.609Z"
    }
  ]
}

json

application/json

Delete a contact

DELETE

https://moneybird.com/api/v2

/{administration_id}/contacts/{id}{format}

Deletes a contact.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Delete a contact › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete a contact › Responses

Contact deleted

No data returned

Update a contact

PATCH

https://moneybird.com/api/v2

/{administration_id}/contacts/{id}{format}

When updating a contact, you only need to provide the information you want to change. Attributes you don't provide in the request will not be updated. Optional attributes can be removed by setting them to an empty string value.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Update a contact › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Update a contact › Request Body

object · required

Update a contact › Responses

Contact updated

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean

PATCH/{administration_id}/contacts/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/contacts/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "contact": {
    "company_name": "Test B.V."
  }
}'

Example Request Body

{
  "contact": {
    "company_name": "Test B.V."
  }
}

json

application/json

Example Responses

{
  "id": "499054011234649427",
  "administration_id": 123,
  "company_name": "Test B.V.",
  "firstname": null,
  "lastname": null,
  "address1": "1 Infinite Loop",
  "address2": "",
  "zipcode": "123456",
  "city": "Redmond",
  "country": "NL",
  "phone": "",
  "delivery_method": "Email",
  "customer_id": "2",
  "tax_number": "",
  "chamber_of_commerce": "",
  "bank_account": "NL50TEST0166567191",
  "is_trusted": false,
  "max_transfer_amount": null,
  "attention": "",
  "email": "info@example.com",
  "email_ubl": true,
  "send_invoices_to_attention": "",
  "send_invoices_to_email": "info@example.com",
  "send_estimates_to_attention": "",
  "send_estimates_to_email": "info@example.com",
  "direct_debit": false,
  "sepa_active": true,
  "sepa_iban": "NL50TEST0166567191",
  "sepa_iban_account_name": "Foobar Holding B.V.",
  "sepa_bic": "RABONL2U",
  "sepa_mandate_id": "MAN12313",
  "sepa_mandate_date": "2014-01-01",
  "sepa_sequence_type": "RCUR",
  "credit_card_number": "",
  "credit_card_reference": "",
  "credit_card_type": null,
  "tax_number_validated_at": null,
  "tax_number_valid": null,
  "invoice_workflow_id": null,
  "estimate_workflow_id": null,
  "si_identifier": "",
  "si_identifier_type": null,
  "moneybird_payments_mandate": false,
  "created_at": "2026-09-23T09:16:54.734Z",
  "updated_at": "2026-09-23T09:16:54.754Z",
  "version": 1790155014,
  "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/85afa1878776f2eccaa08b7f5cb886eee81df3880feafa6019d785f1da440b31/all",
  "notes": [],
  "custom_fields": [],
  "contact_people": [
    {
      "id": "499054011237795157",
      "contact_id": "499054011234649427",
      "administration_id": 123,
      "firstname": "John",
      "lastname": "Doe",
      "phone": null,
      "email": null,
      "department": null,
      "created_at": "2026-09-23T09:16:54.737Z",
      "updated_at": "2026-09-23T09:16:54.737Z",
      "version": 1790155014
    }
  ],
  "archived": false,
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "contact_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:16:54.743Z",
      "updated_at": "2026-09-23T09:16:54.743Z"
    },
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "contact_changed",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "changes": {
          "company_name": [
            "Foobar Holding B.V.",
            "Test B.V."
          ]
        }
      },
      "created_at": "2026-09-23T09:16:54.757Z",
      "updated_at": "2026-09-23T09:16:54.757Z"
    }
  ]
}

json

application/json

List all contacts

GET

https://moneybird.com/api/v2

/{administration_id}/contacts{format}

Returns a paginated list of contacts in the administration.

Searching for contacts can be done by providing the query parameter with search terms. The API searches for matches in the following contact fields:

company_name
attention
firstname
lastname
address1
address2
zipcode
city
country
email
phone
customer_id
tax_number
chamber_of_commerce
bank_account

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

List all contacts › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all contacts › query Parameters

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

page

integer | string

query

string

Free-text search across name, contact people, email, phone, customer id, tax number, chamber of commerce, IBAN, and address fields.

include_archived

boolean | string

todo

string

contact_field

string

contact_value

string

contact_import_id

integer | string

Restrict to contacts created by the given contact import batch.

List all contacts › Responses

A list of contacts

contact_response[]

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean

GET/{administration_id}/contacts{format}

curl https://moneybird.com/api/v2/:administration_id/contacts:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "499054012896642755",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": null,
    "lastname": null,
    "address1": "1 Infinite Loop",
    "address2": "",
    "zipcode": "123456",
    "city": "Redmond",
    "country": "NL",
    "phone": "",
    "delivery_method": "Email",
    "customer_id": "2",
    "tax_number": "",
    "chamber_of_commerce": "",
    "bank_account": "NL50TEST0166567191",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": "",
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": "",
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": "",
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "sepa_active": true,
    "sepa_iban": "NL50TEST0166567191",
    "sepa_iban_account_name": "Foobar Holding B.V.",
    "sepa_bic": "RABONL2U",
    "sepa_mandate_id": "MAN12313",
    "sepa_mandate_date": "2014-01-01",
    "sepa_sequence_type": "RCUR",
    "credit_card_number": "",
    "credit_card_reference": "",
    "credit_card_type": null,
    "tax_number_validated_at": null,
    "tax_number_valid": null,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": "",
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-09-23T09:16:56.319Z",
    "updated_at": "2026-09-23T09:16:56.319Z",
    "version": 1790155016,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/d700da482105eb5112e773077971b6643141114ae830b0a4dcab27fdcaceb070/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [
      {
        "id": "499054012899788485",
        "contact_id": "499054012896642755",
        "administration_id": 123,
        "firstname": "John",
        "lastname": "Doe",
        "phone": null,
        "email": null,
        "department": null,
        "created_at": "2026-09-23T09:16:56.323Z",
        "updated_at": "2026-09-23T09:16:56.323Z",
        "version": 1790155016
      }
    ],
    "archived": false,
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "contact_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:16:56.328Z",
        "updated_at": "2026-09-23T09:16:56.328Z"
      }
    ]
  }
]

json

application/json

Create a new contact

POST

https://moneybird.com/api/v2

/{administration_id}/contacts{format}

Creating a new contact in the administration requires at least a company_name or a firstname and lastname. When filling a custom field, both id and value are required. See the custom field example for more information.

Required scope(s)

Any of: estimates, sales_invoices, documents, bank or settings

Create a new contact › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create a new contact › Request Body

object · required

Create a new contact › Responses

Contact created

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

firstname

string | null

lastname

string | null

address1

string | null

address2

string | null

zipcode

string | null

city

string | null

country

string

phone

string | null

delivery_method

string | null · enum

Enum values:

Post

Manual

Simplerinvoicing

Peppol

customer_id

string

Will be assigned automatically if empty

tax_number

string | null

chamber_of_commerce

string | null

bank_account

string | null

The SEPA IBAN of the contact, can be empty if no SEPA IBAN is set

is_trusted

boolean

Default: default

max_transfer_amount

number | null

attention

string | null

email

string | null

email_ubl

boolean

send_invoices_to_attention

string | null

send_invoices_to_email

string | null

send_estimates_to_attention

string | null

send_estimates_to_email

string | null

direct_debit

boolean

sepa_active

boolean | null

sepa_iban

string | null

sepa_iban_account_name

string | null

sepa_bic

string | null

sepa_mandate_id

string | null

sepa_mandate_date

string | null · date

sepa_sequence_type

string · enum

Enum values:

RCUR

FRST

OOFF

FNAL

credit_card_number

string | null

credit_card_reference

string | null

credit_card_type

string | null · enum

Enum values:

mastercard

visa

tax_number_validated_at

string | null · date-time

tax_number_valid

boolean | null

invoice_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

estimate_workflow_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

si_identifier

string | null

si_identifier_type

string | null

moneybird_payments_mandate

boolean

Whether the contact has a valid Moneybird Payments mandate

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

integer

sales_invoices_url

string · uri · pattern: ^https:\/\/moneybird…

archived

boolean