---
title: "PUT /companies/{companySlug}/recurringInvoices/{recurringInvoiceId}/jobs/{jobId}/recipients"
method: PUT
path: "/companies/{companySlug}/recurringInvoices/{recurringInvoiceId}/jobs/{jobId}/recipients"
tags: ["recurring invoices"]
---

# PUT /companies/{companySlug}/recurringInvoices/{recurringInvoiceId}/jobs/{jobId}/recipients

`PUT /companies/{companySlug}/recurringInvoices/{recurringInvoiceId}/jobs/{jobId}/recipients`

## Request

- Base URL: `https://api.fiken.no/api/v2`
- URL: `https://api.fiken.no/api/v2/companies/{companySlug}/recurringInvoices/{recurringInvoiceId}/jobs/{jobId}/recipients`
- Auth: OAuth 2
  - Authorization code: `https://fiken.no/oauth/authorize`
  - Token URL: `https://fiken.no/oauth/token`

Replaces the delivery configuration of a single job — exactly how invoices generated by the job
are sent. Any channel not included in the request is turned off, and the job must end up with at
least one recipient (otherwise the request is rejected). EHF, eFaktura and SMS are mutually
exclusive. EHF requires the customer to have an organization number and a supported currency;
eFaktura requires an approved eFaktura agreement for the company. Vipps is no longer available and
cannot be set.

## Request body

- RecurringInvoiceRecipient: A job's delivery configuration — who the invoice is sent to and how. Returned on recurringInvoiceJobResult.recipients and used as the body of PUT .../recipients. On PUT it fully replaces the job's recipients: any channel not set is turned off, the job must end up with at least one recipient, and EHF, eFaktura and SMS cannot be combined.
  - `emails` string[]: Ad-hoc email addresses that do not belong to a contact person. On GET, recipients whose email matches one of the customer's contact persons are reported under contactPersonIds instead. On PUT these replace the job's email recipients (together with contactPersonIds).
  - `contactPersonIds` integer[]: Contact persons of the job's customer who receive the invoice. On GET, recipients whose email matches one of the customer's contact persons are reported here. On PUT, each contact person's email is added as a recipient (together with emails); all must belong to the customer and have an email.
  - `ehf` boolean: Send as EHF. Requires the customer to have an organization number and a supported currency.
  - `efaktura` boolean: Send as eFaktura. Requires an approved eFaktura agreement for the company.
  - `letter` boolean: Send as letter to the customer's registered address.
  - `smsPhoneNumber` string, nullable: Phone number to notify by SMS. Omit or null to not send by SMS.

## Response `200`

OK

## Changes

- **2026-09-03** `2473dacdb89c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fiken/apis/fiken-api/changes/companies/:companySlug/recurringInvoices/:recurringInvoiceId/jobs/:jobId/recipients/put.md)

---

[API](https://skmtc.dev/fiken/apis/fiken-api.md) - [All operations](https://skmtc.dev/fiken/apis/fiken-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiken/apis/fiken-api/revisions/29111da67f94?raw)