Créer un centre de coût

Endpoint

POST https://api.verifik.co/v2/cost-centers

Crée un centre de coût sur votre compte. Gérer les centres de coût ne consomme pas de crédits.

en-têtes

Nom	Valeur
Content-Type	application/json
Authorization	Bearer <token>

paramètres du corps

name

Type : string
Requis : Oui

Nom affiché, jusqu'à 120 caractères.

code

Type : string
Requis : Oui

Valeur que vous enverrez dans x-cost-center. Lettres, chiffres, ., - et _, jusqu'à 60 caractères. Unique par compte.

country

Type : string
Requis : Oui

Code pays ISO-2, par exemple ES.

active

Type : boolean
Requis : Non

true par défaut.

Exemple de requête

cURL

curl -X POST "https://api.verifik.co/v2/cost-centers" \
  -H "Authorization: Bearer $VERIFIK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Opérations Espagne","code":"SPAIN-OPS","country":"ES"}'

Node.js

const axios = require("axios");

const config = {
  method: "post",
  url: "https://api.verifik.co/v2/cost-centers",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  },
  data: {
    name: "Opérations Espagne",
    code: "SPAIN-OPS",
    country: "ES"
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import os
import requests

response = requests.post(
    "https://api.verifik.co/v2/cost-centers",
    headers={
        "Authorization": f"Bearer {os.environ['VERIFIK_TOKEN']}",
        "Content-Type": "application/json",
    },
    json={"name": "Opérations Espagne", "code": "SPAIN-OPS", "country": "ES"},
)

print(response.json())

Exemple de réponse

200 OK

{
  "data": {
    "_id": "6acfbdda92451bac5d0a7ebe",
    "client": "69c2b824295cd7d276e478ad",
    "name": "Opérations Espagne",
    "code": "SPAIN-OPS",
    "country": "ES",
    "active": true,
    "createdAt": "2026-10-14T17:37:30.469Z",
    "updatedAt": "2026-10-14T17:37:30.469Z"
  }
}

data est le nouvel objet centre de coût.

Réponses d'erreur

Un code déjà utilisé sur le compte :

{
  "message": "cost_center_code_taken",
  "code": "Conflict"
}

Un champ manquant ou invalide, comme name, code ou country :

{
  "message": "\"name\" is required",
  "code": "MissingParameter"
}