Skip to content
Leadtime
English
Esc
navigateopen⌘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
200Invoice contact set successfully
successbooleanrequired
Operation success flag
400Invalid invoice ID or contact ID
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
404Invoice not found or contact not found
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
}