Skip to content
Leadtime
English
Esc
↑↓navigate↵open⌘Jpreview

Set invoice contact ID

Updates the contact ID for an existing invoice. The contact must be a valid organization member from the invoice’s project customer organization.

What happens when you set an invoice contact:

  1. The invoice’s contactId field is updated
  2. The contact must belong to the project’s customer organization
  3. If contactId is set to null, the contact is cleared
  4. The contact will receive the invoice when it is sent via email

Important restrictions:

  • The contact must be a valid organization member from the project’s customer organization
  • Use GET /billing/invoices/invoiceContacts/{projectId} to get available contacts
  • The contact must have a valid email address to receive invoices

Use cases:

  • Set or change the invoice recipient before sending
  • Clear the contact if needed
  • Update contact after invoice creation

What is returned:

  • Success response confirming the contact was set
POST/billing/invoices/setInvoiceContactId
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Request body
requiredapplication/json

Invoice ID and contact ID to set

contactIdobject<uuid> | null

Contact ID (UUID) of the organization member who should receive the invoice. This must be a valid contact from the project's customer organization. Set to null to clear the contact. Use GET /billing/invoices/invoiceContacts/{projectId} to get available contacts.

idstring<uuid>required

Invoice ID (UUID) to update the contact for

Responses
200

Invoice contact set successfully

successbooleanrequired

Operation success flag

400

Invalid invoice ID or contact ID

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

404

Invoice not found or contact not found

Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST "https://leadtime.app/api/public/billing/invoices/setInvoiceContactId" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "123e4567-e89b-12d3-a456-426614174000",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}'
Response
{
  "success": true
}