1. REST API for Oracle Commerce Cloud 22A
  2. Tasks
  3. Store
  4. Store Extension
  5. Admin
  6. Profiles

createProfile

post

/ccapp/v1/profiles

Create Profile. This operation is used to create a profile in Oracle Commerce Cloud for a customer. Optionally takes the x-ccasset-language header to get translated content in another language.

Request

Supported Media Types
Header Parameters
Body ()
Root Schema : createProfile_request
Type: object
Show Source
Example:
{
    "lastName":"K",
    "GDPRProfileP13nConsentGranted":false,
    "customerContactId":"CRMID_12345",
    "gender":"female",
    "roles":[
        {
            "function":"buyer",
            "relativeTo":{
                "id":"900004"
            },
            "repositoryId":"1000002",
            "type":"organizationalRole"
        },
        {
            "function":"custom",
            "relativeTo":{
                "id":"900004"
            },
            "repositoryId":"customOrganizationalRole",
            "type":"organizationalRole"
        }
    ],
    "receiveEmail":"no",
    "active":true,
    "dateOfBirth":null,
    "parentOrganization":"900004",
    "firstName":"bcd",
    "profileType":"b2b_user",
    "loyaltyPrograms":[
        {
            "programName":"XTRAREWARDS",
            "membershipId":"abc123",
            "programId":"prog1",
            "status":"Enrolled"
        },
        {
            "programName":"XTRAREWARDS",
            "membershipId":"xyz123",
            "programId":"prog2",
            "status":"RequestForEnrollment"
        }
    ],
    "shippingAddress":{
    },
    "email":"bcd@example.com",
    "daytimeTelephoneNumber":"212-555-1977",
    "shippingAddresses":[
    ]
}
Nested Schema : creditCards
Type: array
List of user credit cards.
Show Source
Nested Schema : dynamicInternalOnlyProperty
Type: object
the value of the internal only dynamic property
Nested Schema : dynamicProperty
Type: object
the value of the dynamic property
Nested Schema : loyaltyPrograms
Type: array
Loyalty Programs Information
Show Source
Nested Schema : roles
Type: array
List of roles to associate with the user.
Show Source
Nested Schema : profile_shippingAddress
Type: object
Default shipping address of the profile (Deprecated, please use ???shippingAddresses??? instead).
Show Source
Nested Schema : shippingAddresses
Type: array
List of shipping addresses associated with profile.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : billingAddress
Type: object
Default billing address of the profile
Show Source
Nested Schema : cardProps
Type: object
Nested Schema : types
Type: array
The types tagged to the address
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
  • membershipId of the profile for the program. If it is null then it implies profile has unregistered from the program or he is not part of the program because of some other reason.
  • programId of Loyalty Program
  • programName of Loyalty Program
  • status of Enrollment. It must be in any of 'RequestForEnrollment', 'Enrolled', 'RequestForUnenrollment', 'Unenrolled', 'Failed' states
Nested Schema : items
Type: object
Show Source
  • For an organizational role, function of the role to be assigned. Not allowed if type is role.
  • relativeTo
    If not provided, the profile's parent organization will be used. Not allowed if type is role.
  • Repository ID of the role to be assigned. Required for type role and for type organizationalRole if function is custom. Ignored if function is anything other than custom and type is organizationalRole
  • Type of the role which can be organizationalRole or role. If omitted, organizationalRole is assumed.
Nested Schema : relativeTo
Type: object
If not provided, the profile's parent organization will be used. Not allowed if type is role.
Show Source
Nested Schema : types
Type: array
The types tagged to the address
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : profile_shippingAddress_request
Type: object
Shipping address associated with the profile
Show Source
Nested Schema : types
Type: array
The types tagged to the address
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : createProfile_response
Type: object
Show Source
Example Response (application/json)
{
    "id":"110026"
}

Default Response

The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: |Error Code|Description| |------------------|------------------| |22003|If the email passed is null or empty| |22004|If there was any internal error while creating the profile| |22005|If the password passed is null or empty| |100200|Invalid profile type passed.| |22007|If invalid input is provided| |89001|If invalid roles are provided| |22024|{0}({1}) must be a String| |22025|Format for loyaltyPrograms is incorrect. Please refer to API doc for more information| |22026|{0} is either missing or incorrect.| |22027|Invalid state is provided.| |180106|One or more address type ID is invalid| |13001|If role function is given as 'custom' but no repositoryId is given|
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top