Add End User to a Subscription

This operation enables you to add an end user to a subscription. An end user can be member of multiple subscriptions.

You can use this operation to add an end user to any type of subscription.

Quick facts

Method

GET

Returns

  • Accepted response: XML
  • Rejected response: plain text

Available

All regions

Prerequisites

You must have MEP provisioned with OpenMarket, and the following roles set in the user account:

  • Main Roles: Subscription Manager/User
  • Other Roles: View and download user details, HTTP Subscription API user

More information

See MEP Operations and Making Subscription Requests.

Try It Out

If you'd like to try out this call using cURL, see Making Subscription Requests, which will take you through tasks such as creating and disabling subscriptions, and adding or removing end users.

Making a Request

Definition

GET https://cmx2api.openmarket.com/subscriptionapi/adduser?

URL example

https://cmx2api.openmarket.com/subscriptionapi/adduser?username=MyUsername&password=P4S5W0Rd&subscription=A1B2C3D4E5F6&msisdn=12515550130&network=CINGULARUS

Query parameters

Parameters must be URL encoded.

Parameter

Description

username

The username used to access MEP.

Required: yes

Type: string

password

The password associated with the MEP username.

Required: yes

Type: string

subscription

 

The ID of the subscription that you are adding an end user to.

Required: yes

Type: string

msisdn

 

Mobile number of the end user you are adding to the subscription. This must be in international format but without a leading + symbol. For example: 12515550145 (US) or 447700900765 (UK).

Required: yes

Type: integer

network

The end user’s mobile operator. MEP requires the end user mobile operator details for many services.

See also Specifying the network parameter.

Required: no

Default: UNKNOWN

Type: string

Header fields

There is no data required in the header.

Response from OpenMarket

Accepted requests

OpenMarket responds to a successful request with a status code of 200 and the details you have just added in the response body.

HTTP/1.1 200 OK
Date: Tue, 15 Mar 2016 16:36:54 GMT
Server: Apache-Coyote/1.1
Transfer-Encoding: chunked
Content-Type: text/plain

<?xml version="1.0" encoding="ISO-8859-1"?>
<users>
   <user>
      <msisdn>12515550100</msisdn>
      <network>CINGULARUS</network>
      <enabled>true</enabled>
   </user>
</users>

Response body

The XML response body will include following data.

Element

Description

users

Root element. Contains the element: user.

Returned: Always

user

Element containing information about the user.

Returned: Always

msidsn

The end user's phone number.

Type: integer

Returned: Always

network

The end user's mobile operator.

Type: string

Returned: Always

enabled

Set to "true" in the response. This indicates that the end user was added successfully to the subscription.

Type: Boolean

Returned: Always

Rejected requests

If your request is rejected then the body of the response will contain a plain text description of the error. For example:

HTTP/1.1 400 Bad Request
Date: Tue, 15 Mar 2016 11:48:56 GMT
Server: Apache-Coyote/1.1
Connection: close
Transfer-Encoding: chunked
Content-Type: text/plain
			
Your request is invalid, specifically the following parameter is incorrect: subscription=ABCDE

See Response error messages below for a list of the possible error messages.

Testing your integration

As subscription operations do not send messages, the best way to test your integration is directly with MEP. We recommend that you test regularly as you build your campaigns and services in MEP, so that you can troubleshoot any issues faster.

For more information on using each operation, see Making Subscription Requests.

Troubleshooting

Response error messages

These error messages are returned in the response body when there was a problem with receiving the request.

Message

Description

Subscription is disabled. Cannot add user to disabled subscription.

Once disabled, you cannot add any further end users to the subscription via the API or the UI. However, that end users may still be added or removed by a MEP service.

If required, you can re-enable a subscription; however you must do this from the MEP GUI.

Your request is invalid, specifically the following parameter is incorrect: <parameter>=<value>

You request contains a problem with the specified mandatory parameter that has stopped MEP from being able to process the request. If the <value> is “null”, then the parameter name is misspelled or the parameter is missing. Otherwise, the value you specified is invalid or does not match the available options. Correct the error and resend the message.

Your username and/or password is incorrect. Check and try again.

Either the username or the password parameter has not been correctly specified. Both parameters are mandatory. Check that both parameters are specified, and that you have entered the correct values for each parameter.

You do not have the necessary roles or permissions to perform the action: <description>

Your access rights in MEP do not allow you use the operation. The information in the <description> part of the response will tell you the role or permission that you are missing.