Set the birthday date of the given customer

curl --request POST \ --url https://api.bonifiq.com.br/v1/pvt/Customer/{id}/setbirthday \ --header 'Authorization: Basic <encoded-value>' \ --header 'Content-Type: application/json' \ --data ' { "Birthday": "2023-11-07T05:31:56Z" } '

{ "ErrorMessage": "<string>", "ErrorCode": 123, "Result": { "OriginalId": "<string>", "PublicId": "<string>", "Name": "<string>", "Email": "<string>", "Phone": "<string>", "BirthdayDate": "2023-11-07T05:31:56Z", "SignupDate": "2023-11-07T05:31:56Z", "Document": "<string>", "IsEnrolled": true, "ReferralURL": "<string>", "WhatsappReferralUrl": "<string>", "CurrentTier": { "Name": "<string>", "Color": "<string>", "IconUrl": "<string>" }, "BalanceOfPoints": 123, "BalanceCashback": 123 }, "Code": "<string>", "CodeName": "<string>", "HasWarning": true, "HasError": true }

Birthday format

Although we use only the day and month part of the Birthday for compatibility reasons the API expects a DateTime as the Birthday date.

This field is expected to have the ISO 8601 format such as 2023-02-03T14:11:10Z.

Note the trailing Z in the previous example: it means the date is in UTC format. This is important to make sure the date is correct.

Authorizations

Authorization

string

header

required

Use API Basic Auth Keys

Path Parameters

string

required

Body

application/json

Birthday

string<date-time>

Response

200 - application/json

Standard response envelope used by the External API.

ErrorMessage

string | null

Error message returned when the request fails validation or processing. For warnings and successful responses, consumers should usually inspect Result, Code and Severity first.

ErrorCode

integer<int32> | null

Legacy numeric error code derived from internal API errors when available. This field is relevant only for error flows that use ApiResponseErrorDescription.

Result

object

Business payload returned by the endpoint.

Show child attributes

Code

string | null

Endpoint-specific business code formatted as a two-digit string, such as 03 or 07. This field is available for success, warning and error outcomes.

CodeName

string | null

Symbolic enum name associated with Code, such as CheckoutNotFound.

Severity

enum<integer>

Final severity of the response. Success means the action completed as expected, Warning means the request was valid but the business outcome is informational or non-ideal, and Error means the request should be treated as a failure.

Available options:

0,

1,

2

HasWarning

boolean

Convenience flag that is true when Severity is Warning. Warnings are valid 200 OK business outcomes and should not be handled as transport or validation errors.

HasError

boolean

Indicates whether the request failed and should be handled as an error response. This flag is reserved for real API errors; warnings must keep this property as false.