Create a Customer

Create a new customer account in SenderWiz, with optional company information. This is typically used for provisioning new client accounts.

👤 Create a Customer

Use this endpoint to create a customer in SenderWiz. You may also include company details if required.

---

🔹 HTTP Request

POST ADMIN-API-URL/customers

---

🔐 Authorization Header

X-ADMIN-API-KEY: your-admin-api-key-here

---

📝 POST Parameters

Parameter	Type	Required	Description
customer	array	Yes	The array with the customer details.
company	array	No	The array with the company details if required by application settings.

🧍 Customer Block

Parameter	Type	Required	Description
first_name	string	Yes	Customer's first name.
last_name	string	Yes	Customer's last name.
email	string	Yes	Customer's email address.
password	string	Yes	Customer's password.
timezone	string	Yes	Timezone (e.g., UTC).
group	string	Yes	Customer's Group Name
birthDate	string	No	Birth date in YYYY-MM-DD format.

💡 Hint: Customer Groups must be created first in the SenderWiz Admin Panel. Each group controls what a customer can or cannot do — such as whether they can create/upload lists, how many contacts they can manage, or how many emails they’re allowed to send, many other settings. 👉 Use the Group Name (e.g., "Pro-Group") in the group parameter when creating the customer.

🏢 Company Block (Optional)

Parameter	Type	Required	Description
name	string	Yes	Company name.
country	string	Yes	Company country (refer to countries endpoint).
zone	string	Yes	Company zone/state (refer to countries endpoint).
city	string	Yes	Company city.
zip_code	string	Yes	Zip or postal code.
address_1	string	Yes	Main address line 1.
address_2	string	No	Secondary address line 2.

---

💻 PHP Example

// CREATE CUSTOMER
$response = $endpoint->create([
    'customer' => [
        'first_name' => 'Emma',
        'last_name'  => 'Waters',
        'email'      => '[e-mail]',
        'password'   => 'securePass#2025',
        'timezone'   => 'UTC',
        'group'      => 'Pro-Group',
        'birthDate'  => '1988-09-15'
    ],
    // company is optional, unless required from app settings
    'company'  => [
        'name'     => 'Waters Consulting Ltd.',
        'country'  => 'Canada',
        'zone'     => 'Ontario',
        'city'     => 'Toronto',
        'zip_code' => 'M5V3L9',
        'address_1'=> '123 Queen St W',
        'address_2'=> 'Suite 400',
    ],
]);

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';

---

📦 Sample JSON Response

{
  "status": "success",
  "customer_uid": "ab382plq98zr7"
}