Update organisation profile

PUThttps://app.speybooks.com/api/v1/organisation/

Update the organisation's identity: name, VAT number, company number, contact details, address, and business type. Only the fields supplied are changed; omitted fields are left unchanged. An empty string for a nullable field (VAT number, email, website) clears it to null.

Address fields are sent flat, not as a nested address object: addressLine1, addressLine2, city, region, postalCode, and country (ISO 3166-1 alpha-2, for example "GB"). The accepted fields are name, vatNumber, companyNumber, email, phone, website, the six address fields, and businessType (the industry enum or null). The response returns the id, name, slug, and updated timestamp.

Body parameters

addressLine1stringoptionalnullable
Address line 1.
addressLine2stringoptionalnullable
Address line 2.
businessTypestringoptionalnullable
Business sector (it_contractor, construction, consulting, creative, retail, hospitality, healthcare, legal, property, transport, other).
citystringoptionalnullable
City or town.
companyNumberstringoptionalnullable
Companies House registration number (max 20 characters).
countrystringoptional
ISO 3166-1 alpha-2 country code (e.g. GB).
emailstringoptionalnullable
Organisation contact email.
namestringoptional
Organisation display name (1-255 characters).
phonestringoptionalnullable
Organisation contact phone (max 30 characters).
postalCodestringoptionalnullable
Postcode (max 20 characters).
regionstringoptionalnullable
County or region.
vatNumberstringoptionalnullable
VAT registration number (max 20 characters). Empty string clears the value.
websitestringoptionalnullable
Organisation website URL.

Response

200Organisation profile updated. Returns the updated ID, name, slug, and timestamp.
Show response fields
idstring
namestring
slugstring
updatedAtstringdate-time

Error codes

400Validation error or no fields to update.