Public REST Infrastructure

Build on Finalizo API

Programmatically create projects, sync clients, issue handover packs, and query cryptographic sign-off status from your internal tools.

Manage Scoped API Keys →OpenAPI Guide

Bearer Authentication

Keys start with fz_live_ or fz_test_.

Scoped Permissions

Use read, write, or admin scopes per key.

JSON Standard

Responses return data, meta, and error envelopes.

Event Automation

REST endpoints and Zapier polling triggers.

Endpoint Reference

Base URL: https://finalizo.com/api/v1

GET/api/v1/openapi.jsonpublicDownload the OpenAPI 3.1 spec

GET/api/v1/authreadValidate an API key

GET/api/v1/mereadGet the authenticated workspace user

GET/api/v1/projectsreadList projects. Query: status, limit, cursor

POST/api/v1/projectswriteCreate a project and handover pack

GET/api/v1/projects/:idreadGet project details

PATCH/api/v1/projects/:idwriteUpdate project name, status, or launch date

GET/api/v1/projects/:id/packreadGet handover pack items, resources, terms, and masked credentials

POST/api/v1/projects/:id/pack/sendwriteMark the pack as sent and return the client URL

GET/api/v1/projects/:id/signoffreadGet sign-off status for a project

GET/api/v1/clientsreadList clients. Query: limit, cursor

POST/api/v1/clientswriteCreate or update a client by email

GET/api/v1/clients/:idreadGet a client and linked projects

GET/api/v1/signoffsreadList sign-offs. Query: status, limit, cursor

GET/api/v1/templatesreadList built-in handover templates

POST/api/v1/zapier/actions/create-projectwriteZapier action: create project

POST/api/v1/zapier/actions/send-packwriteZapier action: send pack

GET/api/v1/zapier/triggers/pack-sentreadZapier polling trigger: pack sent

GET/api/v1/zapier/triggers/pack-viewedreadZapier polling trigger: pack viewed

GET/api/v1/zapier/triggers/client-signed-offreadZapier polling trigger: client signed off

curl

curl https://finalizo.com/api/v1/projects \
  -H "Authorization: Bearer fz_live_your_key_here"

javascript

const response = await fetch("https://finalizo.com/api/v1/projects", {
  headers: { Authorization: "Bearer fz_live_your_key_here" }
});

const payload = await response.json();

createProject

curl https://finalizo.com/api/v1/projects \
  -X POST \
  -H "Authorization: Bearer fz_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Website closeout",
    "clientName": "Jane Smith",
    "clientEmail": "jane@example.com",
    "projectType": "Web Design",
    "launchDate": "2026-06-01"
  }'

curl https://finalizo.com/api/v1/projects \ -X POST \ -H "Authorization: Bearer fz_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "name": "Website closeout", "clientName": "Jane Smith", "clientEmail": "jane@example.com", "projectType": "Web Design", "launchDate": "2026-06-01" }'