Organizations (Multi-RFC)

Register multiple issuing organizations

You can issue invoices from different tax identification numbers by registering new issuing organizations, either from your dashboard or using the API, with the Create Organization method, as well as the other methods to configure tax data, logo, colors, certificates, etc.

If you also need to manage users, invitations, and granular permissions inside each organization, check the Team and roles guide.

That workflow can be handled either through the API or directly from the dashboard, depending on how much team administration you want to automate.

info

To create organizations, manage users, roles, invites, or API keys, you must authenticate using your User Key, which is a secret key associated with your entire account. You can find it in your Integration Center.

Once an organization exists, you can also configure its operating data with your User Key or with that organization's Live Secret Key (sk_live_*). With the Live Secret Key, you can use me as the organization alias, or send the organization ID explicitly, in endpoints such as /v2/organizations/me/legal, /v2/organizations/me/certificate, /v2/organizations/me/customization, and /v2/organizations/me/series-group. The Test Secret Key (sk_test_*) can only read its own organization information.

Node.js

import Facturapi from 'facturapi'
const facturapi = new Facturapi('sk_user_API_KEY');
const organization = await facturapi.organizations.create({
  name: 'Skynet'
});
// remember to save the organization.id in your own database

C#

var facturapi = new FacturapiClient("sk_user_API_KEY");
var organization = await facturapi.Organization.CreateAsync(new Dictionary<string, object>
{
  ["name"] = "Skynet"
});
// remember to save the organization.Id in your own database

Java

import io.facturapi.Facturapi;
import java.util.Map;

Facturapi facturapi = new Facturapi("sk_user_API_KEY");
var organization = facturapi.organizations().create(Map.of(
  "name", "Skynet"
));
// remember to save the organization.getId() in your own database

PHP

$facturapi = new Facturapi("sk_user_API_KEY");
$organization = $facturapi->Organizations->create([
    "name" => "Skynet"
]);
// remember to save the organization.id in your own database

cURL

curl https://www.facturapi.io/v1/organizations \
  -H "Authorization: Bearer sk_user_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "Skynet"
    }'