Attachments

Upload attachment

Uploads a file and creates an attachment in the authenticated company.

Supported categories. The attachment is stored under company_id (if provided — must be accessible by the API key) or the authenticated company by default. The referenced object_id must belong to that same company (strict company_id match, no cross-company uploads).

  • voicemail — audio file (wav/mp3, ≤20 MB). No object_id required. Returned uuid can be referenced as attachment_uuid in nurture-campaign voicemail steps.
  • candidate — generic candidate file. object_id = candidate ID.
  • application — application attachment (signed docs, offer letters, etc.). object_id = application ID.
  • candidate_comment — attachment for a candidate comment. object_id = comment ID.
  • job_note — attachment for a job note. object_id = job note ID.
  • company_favicon, company_header, company_link_preview — company branding assets. object_id = company ID (must match the authenticated company or a client company the API key can access).

Returns ApiAttachment. Follow url with the same Bearer token to download the file later.

post/attachments

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/attachments
  • Auth: HTTP bearer

Request body

category'voicemail' | 'candidate' | 'application' | 'candidate_comment' | 'job_note' | 'company_favicon' | 'company_header' | 'company_link_preview' required

Attachment category. Determines file-type validation rules and object_id requirements.

company_idinteger nullable

Target company ID. Required only for partner API keys that manage multiple client companies — pick the company the attachment belongs to. If omitted, defaults to the authenticated company. The attachment is stored under this company, and the referenced object_id (when present) MUST belong to this same company — mismatch returns 404.

object_idinteger nullable

Target object ID. Required for every category except voicemail. Resolves to candidate/application/comment/job-note/company per category. The object's company is strictly matched against company_id (or authenticated company when company_id omitted); no cross-company uploads.

Response

Uploaded attachment

uuidstring uuid required

Unique attachment identifier. Stable across API calls; use in referencing endpoints.

urlstring uri nullable required

Absolute download URL (e.g. https://api.100hires.com/v2/attachments/application/{uuid}/{file_name}). Hit with Authorization: Bearer <API_KEY>.

relative_timestring required

Human-readable time since upload (e.g. "2 days ago").

Changes

No recorded changes to this operation across all 1 revision of this API.