curl --request POST \
--url https://api.watchdog.no/v1/parties \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>'})
};
fetch('https://api.watchdog.no/v1/parties', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/parties"
payload = { "name": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"company_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "supplier",
"name": "<string>",
"organization_number": "<string>",
"org_country": "<string>",
"vat_number": "<string>",
"vat_country": "<string>",
"email": "<string>",
"additional_emails": [
"<string>"
],
"website": "<string>",
"address": {
"street": "<string>",
"city": "<string>",
"state": "<string>",
"postal_code": "<string>",
"country_code": "<string>"
},
"domain": "<string>",
"relationships": {
"invoice_count": 1,
"invoice_totals": [
{
"currency_code": "<string>",
"amount": "<string>"
}
],
"agreement_count": 1,
"pending_alert_count": 1,
"blocking_invoice_count": 1,
"blocking_agreement_count": 1,
"access_limit_count": 1,
"purchase_order_count": 1,
"can_delete": true,
"can_merge": true
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "validation_error",
"message": "The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_token",
"message": "The bearer token is missing or invalid.",
"request_id": "req_example"
}
}{
"error": {
"code": "forbidden",
"message": "Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required.",
"request_id": "req_example"
}
}{
"error": {
"code": "not_found",
"message": "company_id names no workspace company you can access.",
"request_id": "req_example"
}
}{
"error": {
"code": "conflict",
"message": "A party of the same type with the same organization number and country, or with no number and the same name, already exists. existing_party identifies it when available. Nothing is saved.",
"request_id": "req_example"
}
}{
"error": {
"code": "company_choice_required",
"message": "You can access several companies: send company_id for a recipient.",
"request_id": "req_example"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Wait for the Retry-After delay before retrying.",
"request_id": "req_example"
}
}{
"error": {
"code": "internal_error",
"message": "Unexpected server failure. Include the request ID when contacting support.",
"request_id": "req_example"
}
}{
"error": {
"code": "service_unavailable",
"message": "Temporarily unavailable. Retry after the Retry-After delay, when provided.",
"request_id": "req_example"
}
}Create a supplier or recipient
Creates a party of the given type. Only type and name are required, and company_id for a recipient in a workspace with several companies. The organization number is validated for recognized countries, and the country is inferred from it when not given. Creating the same party again returns 409.
curl --request POST \
--url https://api.watchdog.no/v1/parties \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>'})
};
fetch('https://api.watchdog.no/v1/parties', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/parties"
payload = { "name": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"company_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "supplier",
"name": "<string>",
"organization_number": "<string>",
"org_country": "<string>",
"vat_number": "<string>",
"vat_country": "<string>",
"email": "<string>",
"additional_emails": [
"<string>"
],
"website": "<string>",
"address": {
"street": "<string>",
"city": "<string>",
"state": "<string>",
"postal_code": "<string>",
"country_code": "<string>"
},
"domain": "<string>",
"relationships": {
"invoice_count": 1,
"invoice_totals": [
{
"currency_code": "<string>",
"amount": "<string>"
}
],
"agreement_count": 1,
"pending_alert_count": 1,
"blocking_invoice_count": 1,
"blocking_agreement_count": 1,
"access_limit_count": 1,
"purchase_order_count": 1,
"can_delete": true,
"can_merge": true
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "validation_error",
"message": "The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_token",
"message": "The bearer token is missing or invalid.",
"request_id": "req_example"
}
}{
"error": {
"code": "forbidden",
"message": "Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required.",
"request_id": "req_example"
}
}{
"error": {
"code": "not_found",
"message": "company_id names no workspace company you can access.",
"request_id": "req_example"
}
}{
"error": {
"code": "conflict",
"message": "A party of the same type with the same organization number and country, or with no number and the same name, already exists. existing_party identifies it when available. Nothing is saved.",
"request_id": "req_example"
}
}{
"error": {
"code": "company_choice_required",
"message": "You can access several companies: send company_id for a recipient.",
"request_id": "req_example"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Wait for the Retry-After delay before retrying.",
"request_id": "req_example"
}
}{
"error": {
"code": "internal_error",
"message": "Unexpected server failure. Include the request ID when contacting support.",
"request_id": "req_example"
}
}{
"error": {
"code": "service_unavailable",
"message": "Temporarily unavailable. Retry after the Retry-After delay, when provided.",
"request_id": "req_example"
}
}Authorizations
Headers
Body
Organization number, at most 100 characters. Numbers from recognized countries must have a valid format and checksum, and are stored without separators. A number that only a VAT register issues, such as DE811907980, is stored as the VAT number. Null or blank clears it.
100VAT number, at most 100 characters. Numbers from recognized countries must have a valid format and checksum, and are stored with their country prefix. Several parties can share one. In Norway, Sweden, Denmark and Finland the VAT number contains the organization number, so entering one for a party without an organization number stores that organization number as well, unless org_country names another country or is null. Null or blank clears it.
100Response
The party record. Editing it does not change the party details printed on invoices (invoiced_as).