--- title: "DSAPPMdlAddDevice (Service)" slug: "dpgw-ig-dsappmdladddevice-service-5-11" updated: 2025-07-04T10:05:55Z published: 2025-07-07T16:28:37Z canonical: "docs.onespan.com/dpgw-ig-dsappmdladddevice-service-5-11" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # DSAPPMdlAddDevice (Service) > API version: 2 > > Availability: DIGIPASS Gateway 5.0 and later > > Authentication: Basic HTTP authentication using the front-end API key. The DSAPPMdlAddDevice service registers a new device that supports Secure Channel activation. ## URL https://dpgateway_host:dpgateway_port/rest/v2/provisioning /DSAPPMdlAddDevice ## Request | DSAPPMdlAddDevice parameters | | --- | | Parameter name | Data type | Description | | deviceCode | String | Required. The device code generated by the DSAPP SDK. | | initialVector | String | Required. The updated initial vector used by the mobile application using the DSAPP SDK. | | nonce | String | Required. The updated encrypted server nonce used by the mobile application using the DSAPP SDK. | | registrationIdentifier | String | Required. The unique identifier of a user for a given activation process. It is returned by DSAPPRegister. | | description | String | Optional. The description of the Digipass instance being activated. Up to 255 characters. Special characters are replaced with spaces. | ### Example ```json {  "registrationIdentifier": "e3wfISG9",  "nonce": "5B983EE185B954A461CEFEECEBBBF214",  "initialVector": "43B525454EFA11CE0F5D1EBFAC5D9127",  "deviceCode": "6887133123"  "description": "myDigipassInstance" } ``` ## Response | DSAPPRegister return values | | --- | | Return value | Description | | resultCodes | A JSON object that contains the return and status codes of the service. | | result | A JSON object that contains the generated registration activation data. | ### Example ```json {  "resultCodes":    {      "returnCodeEnum": "RET_SUCCESS",      "statusCodeEnum": "STAT_SUCCESS",      "returnCode": 0,      "statusCode": 0    },  "result":    {      "instanceActivationMessage": "011665337766495347390016546230343861..."    } } ```