Create partner
Creates a new partner. Only name is required (it must be a non-blank string); partnerCode, vat, sendEventToExternalSystem and settings are optional. The partner is always created under the caller’s own client application - clientApplicationId cannot be set via the request body and is derived from the caller. The created partner is returned including its generated id and dateCreated.
curl --request POST \
--url https://stage-api.findity.com/api/v1/admin/partners \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Findity AB",
"partnerCode": "FINDITY",
"vat": "SE556123456789",
"sendEventToExternalSystem": false,
"settings": {
"showReportOverview": true
}
}
'import requests
url = "https://stage-api.findity.com/api/v1/admin/partners"
payload = {
"name": "Findity AB",
"partnerCode": "FINDITY",
"vat": "SE556123456789",
"sendEventToExternalSystem": False,
"settings": { "showReportOverview": True }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Findity AB',
partnerCode: 'FINDITY',
vat: 'SE556123456789',
sendEventToExternalSystem: false,
settings: {showReportOverview: true}
})
};
fetch('https://stage-api.findity.com/api/v1/admin/partners', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Findity AB',
'partnerCode' => 'FINDITY',
'vat' => 'SE556123456789',
'sendEventToExternalSystem' => false,
'settings' => [
'showReportOverview' => true
]
]),
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"
payload := strings.NewReader("{\n \"name\": \"Findity AB\",\n \"partnerCode\": \"FINDITY\",\n \"vat\": \"SE556123456789\",\n \"sendEventToExternalSystem\": false,\n \"settings\": {\n \"showReportOverview\": true\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://stage-api.findity.com/api/v1/admin/partners")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Findity AB\",\n \"partnerCode\": \"FINDITY\",\n \"vat\": \"SE556123456789\",\n \"sendEventToExternalSystem\": false,\n \"settings\": {\n \"showReportOverview\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://stage-api.findity.com/api/v1/admin/partners")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Findity AB\",\n \"partnerCode\": \"FINDITY\",\n \"vat\": \"SE556123456789\",\n \"sendEventToExternalSystem\": false,\n \"settings\": {\n \"showReportOverview\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "abc123",
"name": "Findity AB",
"partnerCode": "FINDITY",
"vat": "SE556123456789",
"clientApplicationId": "987654321",
"dateCreated": "2026-07-10T08:21:00Z",
"sendEventToExternalSystem": false,
"settings": {
"showReportOverview": true
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Payload used to create a partner. The partner is always created under the caller's own client application - there is no way to set clientApplicationId via this request.
Partner name. Required, must be a non-blank string.
Partner code. Must be unique; if omitted, one is generated automatically. Free-form string - the server does not enforce a length limit or character-set restriction on it beyond the uniqueness check.
VAT number. Free-form string - the server does not validate, normalize, or restrict its format.
Whether events should be sent to an external system
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
Hide child attributes
Number of report groups.
Whether the report overview is shown.
Field configuration settings. Free-form object.
Fortnox integration settings, e.g. partner mapping. Free-form object.
Response
Partner created
Partner resource returned when a partner is created or updated.
Partner external ID
Partner name
Client application that owns the partner
Creation date
Partner code
VAT number
Whether events are sent to an external system
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
Hide child attributes
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.
Number of report groups.
Whether the report overview is shown.
Field configuration settings. Free-form object.
Fortnox integration settings, e.g. partner mapping. Free-form object.
curl --request POST \
--url https://stage-api.findity.com/api/v1/admin/partners \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Findity AB",
"partnerCode": "FINDITY",
"vat": "SE556123456789",
"sendEventToExternalSystem": false,
"settings": {
"showReportOverview": true
}
}
'import requests
url = "https://stage-api.findity.com/api/v1/admin/partners"
payload = {
"name": "Findity AB",
"partnerCode": "FINDITY",
"vat": "SE556123456789",
"sendEventToExternalSystem": False,
"settings": { "showReportOverview": True }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Findity AB',
partnerCode: 'FINDITY',
vat: 'SE556123456789',
sendEventToExternalSystem: false,
settings: {showReportOverview: true}
})
};
fetch('https://stage-api.findity.com/api/v1/admin/partners', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Findity AB',
'partnerCode' => 'FINDITY',
'vat' => 'SE556123456789',
'sendEventToExternalSystem' => false,
'settings' => [
'showReportOverview' => true
]
]),
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"
payload := strings.NewReader("{\n \"name\": \"Findity AB\",\n \"partnerCode\": \"FINDITY\",\n \"vat\": \"SE556123456789\",\n \"sendEventToExternalSystem\": false,\n \"settings\": {\n \"showReportOverview\": true\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://stage-api.findity.com/api/v1/admin/partners")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Findity AB\",\n \"partnerCode\": \"FINDITY\",\n \"vat\": \"SE556123456789\",\n \"sendEventToExternalSystem\": false,\n \"settings\": {\n \"showReportOverview\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://stage-api.findity.com/api/v1/admin/partners")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Findity AB\",\n \"partnerCode\": \"FINDITY\",\n \"vat\": \"SE556123456789\",\n \"sendEventToExternalSystem\": false,\n \"settings\": {\n \"showReportOverview\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "abc123",
"name": "Findity AB",
"partnerCode": "FINDITY",
"vat": "SE556123456789",
"clientApplicationId": "987654321",
"dateCreated": "2026-07-10T08:21:00Z",
"sendEventToExternalSystem": false,
"settings": {
"showReportOverview": true
}
}