Update partner

Updates an existing partner. Only the supplied properties are updated; unknown properties are ignored. For vat and sendEventToExternalSystem, omitting the property leaves its current value unchanged, while sending an explicit null clears it. partnerCode is the exception: a null value is treated the same as omitting the property and never clears the existing partner code, since it cannot be removed via this endpoint. See the request schema for the exact per-property behavior. id and clientApplicationId cannot be changed via this request. The caller must be allowed to administer the partner. Returns the updated partner.

PUT

partners

{partnerId}

Update partner

curl --request PUT \
  --url https://stage-api.findity.com/api/v1/admin/partners/{partnerId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated Partner Name",
  "vat": "SE556123456789"
}
'

import requests

url = "https://stage-api.findity.com/api/v1/admin/partners/{partnerId}"

payload = {
    "name": "Updated Partner Name",
    "vat": "SE556123456789"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Updated Partner Name', vat: 'SE556123456789'})
};

fetch('https://stage-api.findity.com/api/v1/admin/partners/{partnerId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://stage-api.findity.com/api/v1/admin/partners/{partnerId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Updated Partner Name',
    'vat' => 'SE556123456789'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://stage-api.findity.com/api/v1/admin/partners/{partnerId}"

	payload := strings.NewReader("{\n  \"name\": \"Updated Partner Name\",\n  \"vat\": \"SE556123456789\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://stage-api.findity.com/api/v1/admin/partners/{partnerId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Updated Partner Name\",\n  \"vat\": \"SE556123456789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://stage-api.findity.com/api/v1/admin/partners/{partnerId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Updated Partner Name\",\n  \"vat\": \"SE556123456789\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "abc123",
  "name": "Updated Partner Name",
  "partnerCode": "FINDITY",
  "vat": "SE556123456789",
  "clientApplicationId": "987654321",
  "dateCreated": "2026-07-10T08:21:00Z",
  "sendEventToExternalSystem": false,
  "settings": {
    "showReportOverview": true
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

partnerId

string

required

Partner external ID

Example:

"abc123"

Body

application/json

Payload used to update a partner. Only the supplied properties are updated; unknown properties are ignored. id and clientApplicationId cannot be changed.

name

string

Partner name. If supplied, must be a non-blank string.

partnerCode

string | null

Partner code, must be unique. Free-form string - the server does not enforce a length limit or character-set restriction on it beyond the uniqueness check. Omitting this property leaves the current partner code unchanged. Sending an explicit null is also treated as omission and never clears the partner code - it cannot be cleared via this endpoint. This is unlike vat and sendEventToExternalSystem below, where null is a meaningful value that clears the field; despite nullable: true being set here too, for partnerCode specifically null behaves exactly like omitting the property.

vat

string | null

VAT number. Free-form string - the server does not validate, normalize, or restrict its format. Omitting this property leaves the current VAT number unchanged. Sending an explicit null clears it.

sendEventToExternalSystem

boolean | null

Whether events should be sent to an external system. Omitting this property leaves the current value unchanged. Sending an explicit null clears it.

settings

object

Partner settings map. Only these top-level keys are allowed: maxNumberOfCards, numberOfReportGroups, showReportOverview, fieldSettings, fortnox. Any other top-level key is rejected with INVALID_PARTNER_SETTINGS_KEY.

Hide child attributes

settings.numberOfReportGroups

integer

Number of report groups.

settings.showReportOverview

boolean

Whether the report overview is shown.

settings.fieldSettings

object

Field configuration settings. Free-form object.

settings.fortnox

object

Fortnox integration settings, e.g. partner mapping. Free-form object.

Response

Partner updated

Partner resource returned when a partner is created or updated.

string

required

Partner external ID

name

string

required

Partner name

clientApplicationId

string

required

Client application that owns the partner

dateCreated

string<date-time>

required

Creation date

partnerCode

string | null

Partner code

vat

string | null

VAT number

sendEventToExternalSystem

boolean | null

Whether events are sent to an external system

settings

object

Hide child attributes

settings.maxNumberOfCards

integer

read-only

Maximum number of cards. Server-computed; always 2. Marked read-only for documentation purposes only - the server does not reject a create/update request that includes this property. If sent, the value is silently ignored: the server always overwrites it with 2 rather than returning a validation error or persisting the submitted value.

settings.numberOfReportGroups

integer

Number of report groups.

settings.showReportOverview

boolean

Whether the report overview is shown.

settings.fieldSettings

object

Field configuration settings. Free-form object.

settings.fortnox

object

Fortnox integration settings, e.g. partner mapping. Free-form object.

⌘I

Update partner

curl --request PUT \
  --url https://stage-api.findity.com/api/v1/admin/partners/{partnerId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated Partner Name",
  "vat": "SE556123456789"
}
'

import requests

url = "https://stage-api.findity.com/api/v1/admin/partners/{partnerId}"

payload = {
    "name": "Updated Partner Name",
    "vat": "SE556123456789"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Updated Partner Name', vat: 'SE556123456789'})
};

fetch('https://stage-api.findity.com/api/v1/admin/partners/{partnerId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://stage-api.findity.com/api/v1/admin/partners/{partnerId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Updated Partner Name',
    'vat' => 'SE556123456789'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://stage-api.findity.com/api/v1/admin/partners/{partnerId}"

	payload := strings.NewReader("{\n  \"name\": \"Updated Partner Name\",\n  \"vat\": \"SE556123456789\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://stage-api.findity.com/api/v1/admin/partners/{partnerId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Updated Partner Name\",\n  \"vat\": \"SE556123456789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://stage-api.findity.com/api/v1/admin/partners/{partnerId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Updated Partner Name\",\n  \"vat\": \"SE556123456789\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "abc123",
  "name": "Updated Partner Name",
  "partnerCode": "FINDITY",
  "vat": "SE556123456789",
  "clientApplicationId": "987654321",
  "dateCreated": "2026-07-10T08:21:00Z",
  "sendEventToExternalSystem": false,
  "settings": {
    "showReportOverview": true
  }
}

Authentication

Findity Expense API

Findity Admin API

Findity Admin API V0

Findity Connect API

Update partner

Authorizations

Path Parameters

Body

Response