Update Billing Group | Deel. PayAndBill API Documentation

curl -X PATCH https://{{baseurl}}/billing-groups/billingGroupUuid \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "billingGroupName": "Updated Billing Group",
  "invoiceName": "Updated Invoice Name",
  "primaryEmailRecipient": "primary@example.com",
  "tradingName": "Updated Trading Name",
  "customerUuid": "123e4567-e89b-12d3-a456-426655440000",
  "phone": {
    "countryCode": "+44",
    "number": "1234567890"
  },
  "address": {
    "line1": "5221B Baker Street",
    "townCity": "London",
    "country": "England",
    "postcode": "E1 6AN"
  }
}'

{
  "uuid": "0f98c866-a458-4db5-9950-0fb996042520",
  "billingGroupName": "Default Billing Group",
  "invoiceName": "Acme Invoice",
  "tradingName": "Acme",
  "primaryEmailRecipient": "billing@acme.com",
  "additionalEmailRecipient": "string",
  "customerUuid": "45b0d09b-bc25-4b45-af21-dc15cba56ce2",
  "phone": {
    "countryCode": "+44",
    "number": "1234567890"
  },
  "address": {
    "line1": "5221B Baker Street",
    "line2": "string",
    "townCity": "London",
    "country": "England",
    "foreignCountry": "string",
    "postcode": "E1 6AN"
  }
}

Update billing group details. All fields are optional. Returns the updated billing group.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

billingGroupUuidstringRequired

Request

This endpoint expects an object.

billingGroupNamestringOptional<=250 characters

invoiceNamestringOptional<=250 characters

primaryEmailRecipientstringOptionalformat: "email"<=100 characters

additionalEmailRecipientstringOptionalformat: "email"<=250 characters

tradingNamestringOptional<=250 characters

customerUuidstringOptionalformat: "uuid"

phoneobjectOptional

addressobjectOptional

Response

Successful Response

uuidstringOptionalformat: "uuid"

billingGroupNamestringOptional

invoiceNamestringOptional

tradingNamestringOptional

primaryEmailRecipientstringOptionalformat: "email"

additionalEmailRecipientstringOptionalformat: "email"

customerUuidstringOptionalformat: "uuid"

phoneobjectOptional

addressobjectOptional

Errors

400

Bad Request Error

404

Not Found Error

Authentication

Path parameters

Headers

Request

Response

Errors