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:
- The invoice’s contactId field is updated
- The contact must belong to the project’s customer organization
- If contactId is set to null, the contact is cleared
- 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
/billing/invoices/setInvoiceContactIdAuthorizationOAuth2 access token · headerrequiredapi:writeAuthorizationBearer token (JWT) · headerrequiredapplication/jsonInvoice ID and contact ID to set
contactIdobject<uuid> | nullContact 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>requiredInvoice ID (UUID) to update the contact for
Invoice contact set successfully
successbooleanrequiredOperation success flag
Invalid invoice ID or contact ID
Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions
Invoice not found or contact not found