v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Company Attachment

Create Company Attachment and Upload File

Upload a file and create a company attachment. We recommend uploading PDF files for optimal compatibility. However, the following file types are allowed: .qbb, .qbm, .gif, .jpg, .png, .pdf, .xls, .xlsx, .doc and .docx.

Related guides

Manage company attachments

scope: company_attachments:write

post/v1/companies/{company_id}/attachments

Path parameters

company_idstring required

The UUID of the company

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Created

uuidstring required

UUID of the company attachment

namestring required

name of the file uploaded

category'gep_notice' | 'compliance' | 'other' required

The category of the company attachment.

gep_notice: A tax notice attachment
compliance: A compliance attachment
other: Any other attachment type

upload_timestring required

The ISO 8601 timestamp of when an attachment was uploaded