Connect
  1. Order
Connect
  • ConnectID API Reference
  • Overview
    • API lifecycle
    • OAuth 2.0
    • About the URLs
    • Google analytics
    • Unite payment SDK
    • Events
      • Authentication
      • Connect realtime events
      • ConnectID events
  • Customer Data
    • Address
      • Change addresses
      • List addresses
      • List addresses - client mode
      • List addresses for product - client mode
      • List addresses for product
    • Category
      • List category types
      • List category codes
      • List category codes for category type
    • Customer
      • List customer info
      • Change customer Info
      • Search customer - client mode
      • Check customer number - client mode
      • List customer info - client mode
    • External Reference
      • Remove external reference - client mode
      • Change external reference - client mode
      • List external references - client mode
      • Register external reference - client mode
  • Order Management
    • Article
      • Check article price
    • Coupon
      • Check coupon price - client mode
      • List coupon - client mode
      • List coupon for coupon number - client mode
    • Fulfillment
      • Complete order - client mode
    • Order
      • Order Guide
        • Introduction
        • How to register an order
        • Complete order by fulfillment URL
        • Complete order by fulfillment API
        • Q&A for order
      • List orders
        GET
      • Search order details
        POST
      • List order product history
        GET
      • List order status - client mode
        GET
      • Register customer - client mode
        POST
      • Register customer
        POST
      • Register order - client mode
        POST
      • Register order
        POST
    • Reward
      • Check reward - client mode
    • User
      • Assign user - client mode
    • Voucher Coupons
      • List voucher code coupons - client mode
  • Payment Services
    • Invoice
      • List invoice details
      • List invoices - client mode
      • List invoices for product - client mode
      • List invoices and reminders
      • List invoices and reminders for product
      • List basic invoice info
      • List basic invoice info for product
    • InvoiceAddress
      • List invoice address
    • Klarna
      • List klarna recurring tokens
      • Add Klarna token
      • Remove Klarna token
    • Nexi
      • List Nexi subscriptions
      • Add Nexi subscription
      • Remove Nexi subscription
    • PayEx
      • List PayEx tokens
      • Add PayEx token
      • Remove PayEx token
    • Payment
      • List payment methods
      • Pay invoice
      • Change payment method
    • Vipps
      • List vipps agreements
      • Add vipps agreement
      • Remove vipps agreement
  • Privacy
    • Consent
      • Access private data
      • Remove private data
      • List consent event history - client mode
      • List consent text - client mode
      • List consent text history - client mode
      • List consent groups - client mode
      • List consent given issuer - client mode
      • List consent event history
      • List consent given issuer
      • List consent groups
      • Register consent event - client mode
      • Register consent event
    • Permission/Shield
      • List global permissions
      • List enterprise permissions
      • Change enterprise permissions
      • List ordertype permissions
      • Change ordertype permissions
      • Check shield ordertype - client mode
      • Check shield enterprise - client mode
    • Privacy
      • List privacy enterprise
      • Change privacy enterprise
      • List privacy ordertype
      • Change privacy ordertype
  • Product & Services
    • Complaint
      • Register complaint
      • List complaints
    • Delivery
      • List next distributions
      • List next distributions - client mode
    • DeliveryStop
      • Remove delivery stops
      • Register delivery stops
      • List delivery stops
      • List delivery stop - client mode
    • Issue
      • List distributed issues
      • List product issues - client mode
    • Product
      • List products - client mode
      • Check product - client mode
      • List specific products - client mode
    • ProductDeliveryPlan
      • List productdeliveryplan - client mode
    • ProductDependency
      • Check product dependency discount - client mode
    • Sharing
      • Send subscription share invitation
      • Accept subscription share invitation
      • Decline share - client mode
      • List shareable subscription rules
      • List distribution levels
      • Change subscription share invitation details
      • List all shared subscribers
      • Cancel sharing
      • List shareable subscription nets
      • Change shareable subscription nets
      • Change distribution level
    • Subscription
      • List shared subscriptions
      • List subscriptions
      • Start subscription
      • List subscriptions - client mode
  • Recruitment
    • Recruitment
      • Register recruitment - client mode
      • List recruitments
      • List premium recruitments
      • Change premium recruitments
      • Register recruitments
    • RecruitmentCampaign
      • List recruitment campaign - client mode
  • User Data
    • Access
      • Check access
      • Check access - client mode
    • Credential
      • Check credential - client mode
    • Metadata
      • List metadata
      • Change metadata
      • Remove metadata
      • List metadata - client mode
      • Change metadata - client mode
      • Remove metadata - client mode
    • Profile
      • List user profile
      • List external user profiles
  • Diverse
    • External Identity
      • Register external Id - client mode
      • Register customer - client mode
    • Message
      • List messages
      • Send message
      • Send message - client mode
    • Status
      • List status messages
    • Stock
      • Change stocks - client mode
      • List stocks - client mode
      • List stocks for product - client mode
  1. Order

Register customer

Production
https://api.mediaconnect.no/capi
Production
https://api.mediaconnect.no/capi
POST
/v1/customer
Order
The user needs to be logged in to use this endpoint, click here to read more.
API for creating a customer.
Commonly required fields:
companyName or lastName
postalCode
emails or phoneNumbers
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mediaconnect.no/capi/v1/customer' \
--header 'Content-Type: application/json' \
--data-raw '{
    "companyRegistrationNumber": "5646903690",
    "companyName": "Company International Ltd",
    "departmentName": "Support",
    "firstName": "Ola",
    "middleName": "Fjordstrand",
    "lastName": "Nordmann",
    "careOfAddress": "Nedre Vollsgate XII",
    "street": "Grubbegata",
    "streetNumber": 6,
    "entrance": "A",
    "floorType": "H",
    "floor": 6,
    "postalCode": 179,
    "postalPlace": "Oslo",
    "postalAddress": "Postboks 265 Økern",
    "postalAddressPostalCode": "0510",
    "postalAddressPostalPlace": "Oslo",
    "countryCode": "NO",
    "emails": [
        "ola.nordmann@company.com"
    ],
    "phoneNumbers": [
        "+4712345678",
        "+4723339100"
    ]
}'
Response Response Example
200 - Success
{
    "orderId": 9
}

Request

Authorization
OAuth 2.0
Authorization Code
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Authorize URL: https://connectid.no/user/oauth/authorize
Token URL: https://connectid.no/user/oauth/token
Refresh URL: https://connectid.no/user/oauth/token
Scopes:
read-For all access
or
Body Params application/json
companyRegistrationNumber
string 
optional
A valid registration number in an official registry
<= 16 characters
companyName
string 
optional
Name of the company
<= 40 characters
departmentName
string 
optional
Name of the department
<= 40 characters
personsSocialSecurityNumber
string 
optional
A valid personal social security number
<= 16 characters
firstName
string 
optional
First name
<= 30 characters
middleName
string 
optional
Middle name
<= 30 characters
lastName
string 
optional
Last name
<= 30 characters
careOfAddress
string 
optional
Extra address line if needed
<= 40 characters
street
string 
optional
Street address
<= 40 characters
streetNumber
integer 
optional
Street number
entrance
string 
optional
Entrance
<= 12 characters
floorType
string 
optional
Valid values:
H: Main floor
U: Lower floor
L: Attic
K: Basement
<= 1 characters
floor
integer 
optional
Floor
suite
string 
optional
Suite
<= 10 characters
postalCode
string 
optional
A valid postal code for the street address
<= 10 characters
postalPlace
string 
optional
Postal place
<= 30 characters
postalAddress
string 
optional
Postal address
<= 40 characters
postalAddressPostalCode
string 
optional
A valid postal code for the postal address
<= 10 characters
postalAddressPostalPlace
string 
optional
Postal place for the postal address.
<= 30 characters
countryCode
string 
optional
The country code for this address - ISO 3166 - alpha-2
<= 3 characters
birthDate
integer 
optional
Birth date if this is a person.
Unix Epoch timestamps in milliseconds since 1st January 1970 UTC.
sex
enum<string> 
optional
Valid values
male: The person is a male.
female: The person is a female.
unknown: The gender is unknown.
Allowed values:
malefemaleunknown
emails
array[string <email>]
optional
A list of email addresses beloning to the person or company. 0, 1 or 2 addresses (each address maximum 255 characters)
>= 0 items<= 2 items
phoneNumbers
array[string]
optional
A list of phone numbers. Up to four phone numbers may be submitted.
A phone number has to follow the telephone number standard E.164
<= 4 items
categories
array [object {2}] 
optional
Custom data possible to add to any address record. Valid categories are found through the different category APIs.
addressCategory
string 
optional
The address category to add to the address record.
<= 12 characters
freeValue
string 
optional
On rare occasions, a free value can be added to the category data. Usually not allowed.
<= 30 characters
permissions
array [object {5}] 
optional
Permission data possible to add to any address record. Permissions is not a required element.
enterpriseCode
string 
required
Enterpise code
<= 12 characters
orderTypeCode
string 
optional
Ordertype code, required if permissions is applied on order type level.
<= 12 characters
channels
array[string]
required
List with permission details on distribution channel code.
channelCode
string 
required
Distribution channel code.
<= 20 characters
permissionType
enum<string> 
required
Valid values:
permission
shield
Allowed values:
permissionshield
privacy
array [object {3}] 
optional
Privacy permission data possible to add to any address record. Privacy permissions are not a required.
enterpriseCode
string 
required
Enterpise code
<= 12 characters
orderTypeCode
string 
optional
Ordertype code, required if permissions is applied on order type level.
<= 12 characters
purpose
string 
required
Purpose of this permission. For example EM, TM etc.
<= 20 characters
Examples

Responses

🟢200OK
application/json
OK
Body
orderId
integer 
optional
OrderId for created order.
🟠400Bad Request
🟠429429
🔴500Server Error
Modified at 2025-05-06 08:28:53
Previous
Register customer - client mode
Next
Register order - client mode
Built with