BillptCreateContact

Description

Creates a contact/customer on the Bill.pt platform. Contacts are required to issue tax documents such as invoices and quotes.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	Bill.pt credential with API Token
name	text	Yes	Contact or company name
fiscal_id	text	No	Tax ID / Tax identification number
email	text	No	Contact email
phone	text	No	Contact phone number
address	text	No	Postal address
city	text	No	City
zip_code	text	No	Postal code (e.g.: 1000-001)
country	text	No	ISO country code (default: PT)

Credentials

This module requires a billpt type credential with the following fields:

• API Token: Bill.pt API access token

Output

{
  "success": true,
  "contact": { ... },
  "contact_id": 123,
  "message": "Contacto \"Empresa XYZ\" creado exitosamente"
}

API

POST /contacts - https://api.bill.pt

Usage Example

{
  "name": "Empresa XYZ Lda",
  "fiscal_id": "123456789",
  "email": "contacto@empresa.pt",
  "phone": "+351 210 000 000",
  "address": "Rua Principal 100",
  "city": "Lisboa",
  "zip_code": "1000-001",
  "country": "PT"
}

Notes

• The name field is required and can be a person’s or company’s name
• The fiscal_id (NIF) is important for valid tax documents in Portugal
• The default country code is PT (Portugal)
• If a contact already exists with the same NIF, a duplicate error may occur

Related Nodes

• BillptGetContacts - Get contacts
• BillptCreateDocument - Create tax document
• BillptCreateReceipt - Create receipt