Create a company customer

post https://app.pennylane.com/api/external/v2/company_customers

This endpoint returns the created company customer.

⚠️ ALPHA STATUS NOTICE

This endpoint is currently in alpha. It is part of an early testing phase, and its functionality may change or be removed in future updates.
We welcome your feedback to help us improve. Please use this endpoint with caution, especially in production environments, as backward compatibility is not guaranteed and functionality may change frequently.
This feature is best suited for developers interested in testing and providing input on upcoming capabilities.

ℹ️
This endpoint requires one of the following scopes: customers:all

Body Params

name

string

required

vat_number

string

reg_no

string

ledger_account

object | null

phone

string

billing_address

object

required

delivery_address

object

payment_conditions

string

Defaults to 30_days

Note that the custom option is only used on Pennylane's web app to avoid pre-filling the deadline when creating an invoice. On the API it has no effect and you will still have to provide a deadline when creating an invoice.

billing_iban

string | null

recipient

string

The name of the person to whom the invoice is addressed

reference

string | null

notes

string | null

emails

array of strings

emails

external_reference

string

You can use your own unique value when creating the customer. If not provided, Pennylane will pick one for you. Value must be unique

billing_language

string

The language in which the customer will receive invoices. Default is fr_FR

Responses

Response body

object

integer

required

name

string

required

billing_iban

string | null

required

payment_conditions

string

required

upon_receipt custom 15_days 30_days 45_days 60_days

recipient

string

required

The name of the person to whom the invoice is addressed

phone

string

required

reference

string | null

required

notes

string | null

required

vat_number

string

required

reg_no

string

required

ledger_account

object | null

required

integer

required

emails

array of strings

required

emails*

billing_address

object

required

address

string

required

postal_code

string

required

city

string

required

country_alpha2

string

required

delivery_address

object

required

address

string

required

postal_code

string

required

city

string

required

country_alpha2

string

required

created_at

date-time

required

updated_at

date-time

required

external_reference

string

required

The unique external reference assigned to this customer, assigned on creation either by you or Pennylane. (Same attribute as source_id in the API v1)

billing_language

string

required

The language in which the customer will receive invoices. Default is fr_FR

fr_FR en_GB de_DE

Language

Credentials

OAuth2


xxxxxxxxxx
1
curl --request POST \
2
     --url https://app.pennylane.com/api/external/v2/company_customers \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "payment_conditions": "30_days"
8
}
9
'


xxxxxxxxxx
34
}
1
{
2
  "id": 42,
3
  "name": "My Company",
4
  "billing_iban": "FR1420041010050500013M02606",
5
  "payment_conditions": "upon_receipt",
6
  "recipient": "John Doe",
7
  "phone": "+33612345678",
8
  "reference": "REF-1234",
9
  "notes": "Some notes",
10
  "vat_number": "FR12345678901",
11
  "reg_no": "123456789",
12
  "ledger_account": {
13
    "id": 0
14
  },
15
  "emails": [
16
    "hello@example.org"
17
  ],
18
  "billing_address": {
19
    "address": "string",
20
    "postal_code": "string",
21
    "city": "string",
22
    "country_alpha2": "string"
23
  },
24
  "delivery_address": {
25
    "address": "string",

201Returns the created company customer

400Bad request

401Access token is missing or invalid

403Access to this resource forbidden

404The resource was not found

409Conflict with the current state of the target resource, such as when trying to create a resource that already exists.

422Unprocessable entity