PUT
/
api
/
external
/
v2
/
individual_customers
/
{id}
Update an individual customer
curl --request PUT \
  --url https://app.pennylane.com/api/external/v2/individual_customers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+33612345678",
  "billing_address": {
    "address": "8 rue de la paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_alpha2": "FR"
  },
  "delivery_address": {
    "address": "8 rue de la paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_alpha2": "FR"
  },
  "payment_conditions": "upon_receipt",
  "billing_iban": "FR1420041010050500013M02606",
  "recipient": "John Doe",
  "reference": "REF-1234",
  "notes": "Some notes",
  "emails": [
    "[email protected]"
  ],
  "external_reference": "0e67fc3c-c632-4feb-ad34-e18ed5fbf66a",
  "billing_language": "fr_FR"
}'
{
  "id": 42,
  "name": "John Doe",
  "billing_iban": "FR1420041010050500013M02606",
  "payment_conditions": "upon_receipt",
  "recipient": "John Doe",
  "phone": "+33612345678",
  "reference": "REF-1234",
  "notes": "Some notes",
  "first_name": "John",
  "last_name": "Doe",
  "ledger_account": {
    "id": 123
  },
  "emails": [
    "[email protected]"
  ],
  "billing_address": {
    "address": "<string>",
    "postal_code": "<string>",
    "city": "<string>",
    "country_alpha2": "<string>"
  },
  "delivery_address": {
    "address": "<string>",
    "postal_code": "<string>",
    "city": "<string>",
    "country_alpha2": "<string>"
  },
  "created_at": "2023-08-30T10:08:08.146343Z",
  "updated_at": "2023-08-30T10:08:08.146343Z",
  "external_reference": "0e67fc3c-c632-4feb-ad34-e18ed5fbf66a",
  "billing_language": "fr_FR",
  "mandates": {
    "url": "https://app.pennylane.com/api/external/v2/gocardless_mandates?filter=%5B%7B%5C\"field%5C\":%5C\"customer_id%5C\",%5C\"operator%5C\":%5C\"eq%5C\",%5C\"value%5C\":%5C\"42%5C\"%7D%5D"
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
id
string
required

Individual customer identifier

Body

application/json
​
first_name
string
Example:

"John"

​
last_name
string
Example:

"Doe"

​
phone
string
Example:

"+33612345678"

​
billing_address
object
​
delivery_address
object | null
​
payment_conditions
enum<string>

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.

Available options:
upon_receipt,
custom,
15_days,
30_days,
45_days,
60_days
​
billing_iban
string | null
Example:

"FR1420041010050500013M02606"

​
recipient
string
Example:

"John Doe"

​
reference
string | null
Example:

"REF-1234"

​
notes
string | null
Example:

"Some notes"

​
emails
string[]
Example:
["[email protected]"]
​
external_reference
string

The unique external reference assigned to this customer, assigned on creation either by you or Pennylane.

Example:

"0e67fc3c-c632-4feb-ad34-e18ed5fbf66a"

​
billing_language
enum<string>

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

Available options:
fr_FR,
en_GB,
de_DE

Response

Returns the updated individual customer

​
id
integer
required
Example:

42

​
name
string
required
Example:

"John Doe"

​
billing_iban
string | null
required
Example:

"FR1420041010050500013M02606"

​
payment_conditions
enum<string>
required

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.

Available options:
upon_receipt,
custom,
15_days,
30_days,
45_days,
60_days
​
recipient
string
required
Example:

"John Doe"

​
phone
string
required
Example:

"+33612345678"

​
reference
string | null
required
Example:

"REF-1234"

​
notes
string | null
required
Example:

"Some notes"

​
first_name
string
required
Example:

"John"

​
last_name
string
required
Example:

"Doe"

​
ledger_account
object | null
required
​
emails
string[]
required
Example:
["[email protected]"]
​
billing_address
object
required
​
delivery_address
object
required
​
created_at
string<date-time>
required
Example:

"2023-08-30T10:08:08.146343Z"

​
updated_at
string<date-time>
required
Example:

"2023-08-30T10:08:08.146343Z"

​
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)

Example:

"0e67fc3c-c632-4feb-ad34-e18ed5fbf66a"

​
billing_language
enum<string>
required

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

Available options:
fr_FR,
en_GB,
de_DE
​
mandates
object
required

GoCardless mandates associated with this customer