AdminConsole
API reference/Workmate Workforce
POSTstatefullegacy-source evidence

To create new client

/clients

Create Client API allows you to add a new client to your organization. Using this API, You can create a new client with a name, address, lat,long, contact details, Department along with their contact details.

Build a requestGet credentials
Legacy contract evidence

This operation was normalized from a MapmyIndia-generation specification. Validate its current Mappls host, path, package entitlement, authentication generation, and commercial availability before production use.

Request target

Call the operation

POSThttps://workmate.mapmyindia.com/apis/clients
Base URLhttps://workmate.mapmyindia.com/apis/
Authenticationoauth2 bearer
Journey rolecommand
Content typesapplication/json
Path, query, and headers

Parameters

NameLocationTypeDescriptionExample
apiVersionrequired
headerstring

API version should be mentioned in the header along with bearer Token. Available version is v1.0.0, Default version is v1.0.0

v1.0.0
Request body

Body schema

FieldTypeDescriptionExample
clientNamerequired
string

Name of the client or customer location

ABN pvt.ltd
address
string

Client location address.

237, okhla phase 3, new delhi -110020
contactPersonName
string

Clients or customers Contact person name

Dinesh
emailId
string

Clients or Customers contact email id.

workmate@mapmyindia.com
mobileNo
string

Client or Customer contact mobile number

9348332321
typeId
integer

Customer or client category based on your compnay details

1
lat
number

Latitude of the client location.

28.612964
long
number

Longitude of the client location.

77.268118
viewRight
integer

Clients view right to the users. 0-public , 1-team , 2-manager

2
departments
array<object>

Departments details associated with the clients

example
departments[].name
string

Name of the department

product team
departments[].contactPersonName
string

Name of the department contact person

sundaram
departments[].mobileNo
string

Department cotnact person mobile number

9349439334
departments[].emailId
string

Department cotnact person email Id

sales@mapmyindia.com
Request body example
{
  "clientName": "ABN pvt.ltd"
}
Interactive, local, and credential-safe

Build your request in eight languages

Change source-backed examples once, validate required inputs, and copy the synchronized cURL, JavaScript, Python, Java, C#, Go, PHP, or Ruby request. Credentials remain environment references, and this page never sends a provider request.

Local request composerCode stays local · fixtures are explicit
POSTRequest inputs
1 editable · 0 protected
Generated in eight languages
Environment-backed credentials
POSThttps://workmate.mapmyindia.com/apis/clients
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request POST \
  --url 'https://workmate.mapmyindia.com/apis/clients' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{"clientName":"ABN pvt.ltd"}'

Credential-safe by constructionSet MAPPLS_ACCESS_TOKEN only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Five language quickstarts

Send a production-shaped request

Examples use environment-backed access tokens, explicit timeouts where supported, status checks, and JSON bodies derived from the source schema. Replace sample identifiers and coordinates with values from your application.

POST /clients
curl --request POST \
  --url 'https://workmate.mapmyindia.com/apis/clients' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "clientName": "ABN pvt.ltd"
}'
Success and failure behavior

Responses

201

Client Created

400

Bad Request - Invalid ID supplied or invalid data type.

401

Unauthorized Request. Access to API is forbidden.

403

The user type is Field user. Only manager and admin type users have the access to this API

404

Not Found - URL Not Found

201 response fields

FieldTypeDescriptionExample
id
number

Unique Id of the client

1212
Response example
{
  "id": 1212
}
stateful integration

Operate it safely

command

This operation creates or triggers durable state. Supply an idempotency strategy and persist the returned identifier before continuing.

Keep credentials and raw tokens out of source, client bundles, prompts, and logs.Record the operation ID, status, latency, retry count, and source contract version in traces.Classify 4xx responses before retrying; back off and add jitter for retryable 5xx or transport failures.Persist resource identifiers and apply commands exactly once in effect across retries and event replay.
Auditable source

Contract provenance

Source file
contenthub/dochub/mapmyindia-workmate-apis/custom/Client-Management.json
SHA-256
61d557dd95d6c5b53e7beff879c160d64a1a449abd0f1a5ed3b76f6e7ff467ce
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.