--- title: "Step 4: Verify registration account" description: The registration flow requires verification of the new account. The POST /{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}} operation continues the flow by sending a verification passcode to the email address specified as a formData property in the previous step. component: pingone-api page_id: pingone-api:workflow-library:pingone-davinci/davinci-registration-flow-with-pingone-auth/test-the-workflow/step-7-verify-account canonical_url: https://developer.pingidentity.com/pingone-api/workflow-library/pingone-davinci/davinci-registration-flow-with-pingone-auth/test-the-workflow/step-7-verify-account.html section_ids: headers: Headers body: Body example-request: Example Request example-response: Example Response --- # Step 4: Verify registration account ## ```none POST {{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}} ``` The registration flow requires verification of the new account. The `POST /{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}` operation continues the flow by sending a verification passcode to the email address specified as a `formData` property in the previous step. In this request: * `id` represents the ID returned by the previous step in the flow. * `event_name` is the event name returned by the authorize request. For this call the event name is `continue`. * `parameters.eventType` specifies the `submit` action. * `parameters.data.actionKey` specifies the action. In this workflow, the action is `VERIFY`. * `parameters.data.formData.passcode` provides a field to submit the passcode that PingOne sent to the email address specified in the previous step. | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------- | | | To return JSON instead of HTML in the response, this request includes an optional `X-Requested-With` HTTP header with its value set to `ping-sdk`. | ### Headers Content-Type      application/json X-Requested-With      ping-sdk interactionId      {{interactionID}} interactionToken      {{interactionToken}} ### Body raw ( application/json ) ```json { "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode" : "xxxxxxx" } } } } ``` ## ### Example Request * cURL * C# * Go * HTTP * Java * jQuery * NodeJS * Python * PHP * Ruby * Swift ```shell curl --location --globoff '{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}' \ --header 'X-Requested-With: ping-sdk' \ --header 'interactionId: {{interactionID}}' \ --header 'interactionToken: {{interactionToken}}' \ --header 'Content-Type: application/json' \ --data '{ "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode" : "xxxxxxx" } } } }' ``` ```csharp var options = new RestClientOptions("{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("", Method.Post); request.AddHeader("X-Requested-With", "ping-sdk"); request.AddHeader("interactionId", "{{interactionID}}"); request.AddHeader("interactionToken", "{{interactionToken}}"); request.AddHeader("Content-Type", "application/json"); var body = @"" + "\n" + @"{" + "\n" + @" ""id"": ""{{ID}}""," + "\n" + @" ""eventName"": ""continue""," + "\n" + @" ""parameters"": {" + "\n" + @" ""eventType"": ""submit""," + "\n" + @" ""data"": {" + "\n" + @" ""actionKey"": ""VERIFY""," + "\n" + @" ""formData"": { " + "\n" + @" ""passcode"" : ""xxxxxxx"" " + "\n" + @" }" + "\n" + @" }" + "\n" + @" }" + "\n" + @"}" + "\n" + @"" + "\n" + @""; request.AddStringBody(body, DataFormat.Json); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content); ``` ```golang package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}" method := "POST" payload := strings.NewReader(`{ "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode" : "xxxxxxx" } } } }`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("X-Requested-With", "ping-sdk") req.Header.Add("interactionId", "{{interactionID}}") req.Header.Add("interactionToken", "{{interactionToken}}") req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` ```http POST /{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}} HTTP/1.1 Host: {{authPath}} X-Requested-With: ping-sdk interactionId: {{interactionID}} interactionToken: {{interactionToken}} Content-Type: application/json { "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode" : "xxxxxxx" } } } } ``` ```java OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "\n{\n \"id\": \"{{ID}}\",\n \"eventName\": \"continue\",\n \"parameters\": {\n \"eventType\": \"submit\",\n \"data\": {\n \"actionKey\": \"VERIFY\",\n \"formData\": { \n \"passcode\" : \"xxxxxxx\" \n }\n }\n }\n}\n\n"); Request request = new Request.Builder() .url("{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}") .method("POST", body) .addHeader("X-Requested-With", "ping-sdk") .addHeader("interactionId", "{{interactionID}}") .addHeader("interactionToken", "{{interactionToken}}") .addHeader("Content-Type", "application/json") .build(); Response response = client.newCall(request).execute(); ``` ```javascript var settings = { "url": "{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}", "method": "POST", "timeout": 0, "headers": { "X-Requested-With": "ping-sdk", "interactionId": "{{interactionID}}", "interactionToken": "{{interactionToken}}", "Content-Type": "application/json" }, "data": JSON.stringify({ "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode": "xxxxxxx" } } } }), }; $.ajax(settings).done(function (response) { console.log(response); }); ``` ```javascript var request = require('request'); var options = { 'method': 'POST', 'url': '{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}', 'headers': { 'X-Requested-With': 'ping-sdk', 'interactionId': '{{interactionID}}', 'interactionToken': '{{interactionToken}}', 'Content-Type': 'application/json' }, body: JSON.stringify({ "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode": "xxxxxxx" } } } }) }; request(options, function (error, response) { if (error) throw new Error(error); console.log(response.body); }); ``` ```python import requests import json url = "{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}" payload = json.dumps({ "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode": "xxxxxxx" } } } }) headers = { 'X-Requested-With': 'ping-sdk', 'interactionId': '{{interactionID}}', 'interactionToken': '{{interactionToken}}', 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text) ``` ```php setUrl('{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}'); $request->setMethod(HTTP_Request2::METHOD_POST); $request->setConfig(array( 'follow_redirects' => TRUE )); $request->setHeader(array( 'X-Requested-With' => 'ping-sdk', 'interactionId' => '{{interactionID}}', 'interactionToken' => '{{interactionToken}}', 'Content-Type' => 'application/json' )); $request->setBody('{\n "id": "{{ID}}",\n "eventName": "continue",\n "parameters": {\n "eventType": "submit",\n "data": {\n "actionKey": "VERIFY",\n "formData": { \n "passcode" : "xxxxxxx" \n }\n }\n }\n}'); try { $response = $request->send(); if ($response->getStatus() == 200) { echo $response->getBody(); } else { echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' . $response->getReasonPhrase(); } } catch(HTTP_Request2_Exception $e) { echo 'Error: ' . $e->getMessage(); } ``` ```ruby require "uri" require "json" require "net/http" url = URI("{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}") http = Net::HTTP.new(url.host, url.port); request = Net::HTTP::Post.new(url) request["X-Requested-With"] = "ping-sdk" request["interactionId"] = "{{interactionID}}" request["interactionToken"] = "{{interactionToken}}" request["Content-Type"] = "application/json" request.body = JSON.dump({ "id": "{{ID}}", "eventName": "continue", "parameters": { "eventType": "submit", "data": { "actionKey": "VERIFY", "formData": { "passcode": "xxxxxxx" } } } }) response = http.request(request) puts response.read_body ``` ```swift let parameters = "{\n \"id\": \"{{ID}}\",\n \"eventName\": \"continue\",\n \"parameters\": {\n \"eventType\": \"submit\",\n \"data\": {\n \"actionKey\": \"VERIFY\",\n \"formData\": { \n \"passcode\" : \"xxxxxxx\" \n }\n }\n }\n}" let postData = parameters.data(using: .utf8) var request = URLRequest(url: URL(string: "{{authPath}}/{{envID}}/davinci/connections/{{connectionID}}/capabilities/{{capabilityName}}")!,timeoutInterval: Double.infinity) request.addValue("ping-sdk", forHTTPHeaderField: "X-Requested-With") request.addValue("{{interactionID}}", forHTTPHeaderField: "interactionId") request.addValue("{{interactionToken}}", forHTTPHeaderField: "interactionToken") request.addValue("application/json", forHTTPHeaderField: "Content-Type") request.httpMethod = "POST" request.httpBody = postData let task = URLSession.shared.dataTask(with: request) { data, response, error in guard let data = data else { print(String(describing: error)) return } print(String(data: data, encoding: .utf8)!) } task.resume() ``` ### Example Response 200 OK ```json { "eventName": "continue", "isResponseCompatibleWithMobileAndWebSdks": true, "id": "h2cy2gkjip", "interactionId": "03702dcc-b2ee-4ffb-927f-253a626c0409", "companyId": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6", "flowId": "6f37adaa00c6bad9d7b4ec966ea0903b", "connectionId": "867ed4363b2bc21c860085ad2baa817d", "capabilityName": "customHTMLTemplate", "form": { "name": "Registration Success", "description": "Account has been successfully created", "category": "CUSTOM_HTML", "components": { "fields": [ { "type": "SUBMIT_BUTTON", "label": "Continue", "key": "NEXT" } ], "inputs": [ { "key": "title", "type": "string", "value": "Success" }, { "key": "textOne", "type": "string", "value": "Your account has been successfully created." }, { "key": "textTwo", "type": "string" } ] } }, "_links": { "next": { "href": "https://auth.pingone.com/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/davinci/connections/867ed4363b2bc21c860085ad2baa817d/capabilities/customHTMLTemplate" }, "self": { "href": "https://auth.pingone.com/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/davinci/connections/867ed4363b2bc21c860085ad2baa817d/capabilities/customHTMLTemplate" } }, "skProxyApiEnvironmentId": "deprecated", "interactionToken": "deprecated" } ```