curl --request PUT \
--url https://api.despezzas.com/v2/business/contacts/{id} \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"address_city": null,
"address_complement": null,
"address_district": null,
"address_number": null,
"address_state": null,
"address_street": null,
"address_zip": null,
"city_code": null,
"document": "12.345.678/0001-90",
"email": "contato@alfa.com.br",
"municipal_inscription": null,
"name": "Distribuidora Alfa",
"notes": null,
"phone": "1133334444",
"type": "supplier"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
address_city: null,
address_complement: null,
address_district: null,
address_number: null,
address_state: null,
address_street: null,
address_zip: null,
city_code: null,
document: '12.345.678/0001-90',
email: 'contato@alfa.com.br',
municipal_inscription: null,
name: 'Distribuidora Alfa',
notes: null,
phone: '1133334444',
type: 'supplier'
})
};
fetch('https://api.despezzas.com/v2/business/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v2/business/contacts/{id}"
payload = {
"address_city": None,
"address_complement": None,
"address_district": None,
"address_number": None,
"address_state": None,
"address_street": None,
"address_zip": None,
"city_code": None,
"document": "12.345.678/0001-90",
"email": "contato@alfa.com.br",
"municipal_inscription": None,
"name": "Distribuidora Alfa",
"notes": None,
"phone": "1133334444",
"type": "supplier"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.despezzas.com/v2/business/contacts/{id}"
payload := strings.NewReader("{\n \"address_city\": null,\n \"address_complement\": null,\n \"address_district\": null,\n \"address_number\": null,\n \"address_state\": null,\n \"address_street\": null,\n \"address_zip\": null,\n \"city_code\": null,\n \"document\": \"12.345.678/0001-90\",\n \"email\": \"contato@alfa.com.br\",\n \"municipal_inscription\": null,\n \"name\": \"Distribuidora Alfa\",\n \"notes\": null,\n \"phone\": \"1133334444\",\n \"type\": \"supplier\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"created_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"name": "Distribuidora Alfa",
"type": "supplier",
"address_city": null,
"address_complement": null,
"address_district": null,
"address_number": null,
"address_state": null,
"address_street": null,
"address_zip": null,
"city_code": null,
"createdAt": "2026-09-01T09:00:00.000Z",
"document": "12345678000190",
"document_type": "cnpj",
"email": "contato@alfa.com.br",
"municipal_inscription": null,
"notes": null,
"phone": "1133334444",
"profile_id": "5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90",
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}Atualizar contato
Escopo necessário: write.
curl --request PUT \
--url https://api.despezzas.com/v2/business/contacts/{id} \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"address_city": null,
"address_complement": null,
"address_district": null,
"address_number": null,
"address_state": null,
"address_street": null,
"address_zip": null,
"city_code": null,
"document": "12.345.678/0001-90",
"email": "contato@alfa.com.br",
"municipal_inscription": null,
"name": "Distribuidora Alfa",
"notes": null,
"phone": "1133334444",
"type": "supplier"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
address_city: null,
address_complement: null,
address_district: null,
address_number: null,
address_state: null,
address_street: null,
address_zip: null,
city_code: null,
document: '12.345.678/0001-90',
email: 'contato@alfa.com.br',
municipal_inscription: null,
name: 'Distribuidora Alfa',
notes: null,
phone: '1133334444',
type: 'supplier'
})
};
fetch('https://api.despezzas.com/v2/business/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v2/business/contacts/{id}"
payload = {
"address_city": None,
"address_complement": None,
"address_district": None,
"address_number": None,
"address_state": None,
"address_street": None,
"address_zip": None,
"city_code": None,
"document": "12.345.678/0001-90",
"email": "contato@alfa.com.br",
"municipal_inscription": None,
"name": "Distribuidora Alfa",
"notes": None,
"phone": "1133334444",
"type": "supplier"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.despezzas.com/v2/business/contacts/{id}"
payload := strings.NewReader("{\n \"address_city\": null,\n \"address_complement\": null,\n \"address_district\": null,\n \"address_number\": null,\n \"address_state\": null,\n \"address_street\": null,\n \"address_zip\": null,\n \"city_code\": null,\n \"document\": \"12.345.678/0001-90\",\n \"email\": \"contato@alfa.com.br\",\n \"municipal_inscription\": null,\n \"name\": \"Distribuidora Alfa\",\n \"notes\": null,\n \"phone\": \"1133334444\",\n \"type\": \"supplier\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"created_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"name": "Distribuidora Alfa",
"type": "supplier",
"address_city": null,
"address_complement": null,
"address_district": null,
"address_number": null,
"address_state": null,
"address_street": null,
"address_zip": null,
"city_code": null,
"createdAt": "2026-09-01T09:00:00.000Z",
"document": "12345678000190",
"document_type": "cnpj",
"email": "contato@alfa.com.br",
"municipal_inscription": null,
"notes": null,
"phone": "1133334444",
"profile_id": "5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90",
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}Authorizations
HTTP Basic com o token como usuário e o secret como senha: curl -u dpz_tk_…:dpz_sk_…. Crie a chave em https://despezzas.com/settings/api-keys.
Path Parameters
Identificador do recurso.
"8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b"
Body
Todos opcionais: só o que for enviado é alterado.
Cidade.
null
Complemento.
null
Bairro.
null
Número.
null
UF.
null
Logradouro.
null
CEP.
null
Código IBGE do município (NFS-e).
null
CPF ou CNPJ (com ou sem máscara).
"12.345.678/0001-90"
E-mail.
"contato@alfa.com.br"
Inscrição municipal (NFS-e).
null
Nome.
"Distribuidora Alfa"
Observações.
null
Telefone.
"1133334444"
Tipo. Padrão: supplier.
customer, supplier, both, partner "supplier"
Response
Sucesso.
Quem cadastrou.
"0d6b923c-3392-424e-a152-2ee32474e8d5"
Id do contato.
"f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b"
Nome.
"Distribuidora Alfa"
Tipo.
customer, supplier, both, partner "supplier"
Cidade.
null
Complemento.
null
Bairro.
null
Número.
null
UF.
null
Logradouro.
null
CEP.
null
Código IBGE do município (NFS-e).
null
Criação.
"2026-09-01T09:00:00.000Z"
CPF/CNPJ (só dígitos).
"12345678000190"
Tipo do documento (derivado).
cpf, cnpj, null "cnpj"
E-mail.
"contato@alfa.com.br"
Inscrição municipal (NFS-e).
null
Observações.
null
Telefone.
"1133334444"
Empresa (perfil de acesso).
"5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90"
Última alteração.
"2026-09-15T14:32:10.000Z"
Dono (contexto pessoal).
null