POST
/
api
/
v1
/
customers
/
corporate-customers
/
update
/
{customer_id}
Update an existing corporate customer.
curl --request POST \
  --url https://demoapi.saasphereltd.com/api/v1/customers/corporate-customers/update/{customer_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_name": "Acme Corp",
  "office_address": "1 Business St",
  "city": "Lagos",
  "lga": "Eti-Osa",
  "state": "Lagos",
  "country": "Nigeria",
  "office_phone": "08012345678",
  "company_email": "info@acme.com",
  "commencement_date": "2020-01-01",
  "sector_id": "5",
  "business_nature": "Trading",
  "annual_revenue": "1000000",
  "annual_turnover": "1200000",
  "form_field": [
    {
      "1": "Field Value 1"
    },
    {
      "2": "Field Value 2"
    }
  ],
  "directors": [
    "DIR001",
    "DIR002"
  ],
  "new_shareholders": [
    {
      "uid": "frontend-auto-generated-id",
      "first_name": "John",
      "surname": "Doe",
      "means_of_id": "national_id",
      "id_card_number": "12345"
    }
  ],
  "documents": [
    "document1.pdf",
    "document2.pdf"
  ]
}
'
{
  "status": "00",
  "message": "Customer has been updated successfully with Customer ID: CUST001",
  "data": []
}

Authorizations

​
Authorization
string
header
required

Paste only the token (no "Bearer " prefix).

Path Parameters

​
customer_id
string
required

The ID of the customer.

Body

application/json
​
company_name
string
required

Company name.

Example:

"Acme Corp"

​
office_address
string
required

Office address.

Example:

"1 Business St"

​
city
string
required

City.

Example:

"Lagos"

​
lga
string
required

LGA.

Example:

"Eti-Osa"

​
state
string
required

State.

Example:

"Lagos"

​
country
string
required

Country.

Example:

"Nigeria"

​
office_phone
string
required

Office phone (digits:11).

Example:

"08012345678"

​
company_email
string
required

Company email.

Example:

"info@acme.com"

​
commencement_date
string
required

Commencement date.

Example:

"2020-01-01"

​
sector_id
string
required

Sector id.

Example:

"5"

​
business_nature
string
required

Business nature.

Example:

"Trading"

​
annual_revenue
string
required

Annual revenue.

Example:

"1000000"

​
annual_turnover
string
required

Annual turnover.

Example:

"1200000"

​
form_field
object[]

optional Array of custom form fields. Each object has a dynamic key (the form_field_id) with the value.

Example:
[
  { "1": "Field Value 1" },
  { "2": "Field Value 2" }
]
​
directors
string[]

optional Array of existing director IDs

Example:
["DIR001", "DIR002"]
​
new_shareholders
object[]

optional Array of new shareholder objects

Example:
[
  {
    "uid": "frontend-auto-generated-id",
    "first_name": "John",
    "surname": "Doe",
    "means_of_id": "national_id",
    "id_card_number": "12345"
  }
]
​
documents
string[]

optional Documents (file uploads)

Example:
["document1.pdf", "document2.pdf"]

Response

200 - application/json
​
status
string
Example:

"00"

​
message
string
Example:

"Customer has been updated successfully with Customer ID: CUST001"

​
data
object