Dadan video recording request API simplified guide

Our API allows businesses to easily create and manage recording requests, generate shareable recording URLs, and seamlessly retrieve completed recordings.

Integrating recording workflows into your business processes with our API is simple and efficient.

• For more information about this API, check out dadan video recording request API overview.

Steps to integrate the dadan recording request #

You don’t need to be a backend engineer to get started. In this section, we’ll show you how to create your first recording request using the API, just like dadan does from the app, but directly from Postman or your script.

Access the developer section #

• Navigate to Account & Preferences from your account menu.

• Choose the Developer section to navigate to the Developer Settings page in your dadan account.

Enable API #

• On the Developer Settings page, you can enable or disable the API integration anytime.
  • Enable: Activates the API and webhook settings.
  • Disable: Deactivates the API and stops webhook notifications.

Authentication API key #

• Your API key authenticates requests to the dadan Video Recording Request API. Keep it secure and do not share it publicly.
  • API Key: You can copy the API key to use in your API requests.
  • The base URL: usually something like https://api.dadan.video.
  • Postman or a similar API tool: or your preferred programming language.

• Click Documentation to view the detailed API specs and instructions.

• Set your authorization:
  • In Postman (or your tool), go to the Headers tab and add the following:
    • X-Dadan-API-Key: Paste your “API key here”
    • Content-Type: application/json
  • Do not use the Authorization tab; the API uses a custom header instead.

Creating a recording request #

• Use the Create Recording Request API with a POST request:
  • Endpoint: https://app.dadan.io/api/v1/usedadan/requestrecording.

• Provide optional parameters:
  • Title, instructions, or request Password in the request body to customize the recording request.
  • Refer to the Request Parameters section for details.

• Set the request body for the optional parameters:
  • In the Body tab (in Postman), select raw and set it to JSON. Provide your custom parameters, for example:

json

{
  "title": "Team Sync Recording",
  "instructions": "Please respond by Friday",
}

⚠️ You must include at least {} in the JSON body.
The API requires a valid JSON body. If you send an empty or incorrectly formatted body, you’ll receive a 400 Bad Request with the message: "A non-empty request body is required."

• Send and Check the Response:
  • Click Send. You’ll get a 200 OK response with a recording link inside if everything is correct. This is your unique dadan link, ready to share or embed anywhere in your workflow.

Alternative example for Command Prompt or Power Shell (bash):

bash

curl --request POST https://app.dadan.io/api/v1/usedadan/requestrecording \
  --header "X-Dadan-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "title": "Quarterly Update",
    "instructions": "Please share your progress by Friday",
    "requestPassword": "1234"
}'

Replace YOUR_API_KEY with your actual API key.

• Try the Link:
  • Open the generated link in a browser. It will take you (or your user) directly to the recording screen, pre-configured with your settings.

This is what dadan’s UI does; you are doing it programmatically now.

Handling webhook notifications #

If you want dadan to notify your system when a recording is submitted, set up a webhook. This allows you to trigger follow-up actions or update your database in real time.

Providing the settings below allows us to send recording details to your specified webhook URL. You can configure authentication headers to secure your webhook integration.

Specify the URL where dadan will send recording notifications. Leave this field empty if you do not wish to receive webhooks.

• Configure a webhook URL in the Webhook Settings to receive real-time updates on recording submissions.
• Set an authentication type (e.g., Basic) and provide key-value pairs if needed.
• Upon submission completion, the API will send a POST request with a JSON payload to your webhook URL, as shown in the “Webhook Submission Notification” example.

json

{
  "recordingTitle": "Quarterly Update",
  "recordingUrl": "https://dadan.io/watch/xyz123",
  "requestCode": "abc456",
  "submittedAt": "2025-05-15T14:22:10Z"
}

This is the JSON payload you’ll receive when a recording is submitted.

• Webhook URL: (Enter your webhook URL here)

• Select the type of authentication to secure your webhook. Options include:
  • None: No authentication
  • Basic: Use a key-value pair for basic authentication

• If you select Basic, provide the following:
  • Key: (Enter the authentication key, e.g., Authorization, X-API-Key)
  • Value: (Enter the corresponding value, e.g., Basic value, Bearer value)

• Save Changes:
  • After configuring your settings, click Save Changes to apply them.

Getting recording request details #

After someone submits a recording, you can use the Get Recording Request API to retrieve its status or video link.

• Endpoint:
  GET https://app.dadan.io/api/v1/usedadan/requestrecording/{code}
• Headers:
  • X-Dadan-API-Key: your-api-key
  • Content-Type: application/json
• Replace {code} with the code you received from the Create API or webhook.

Response #

If successful, you’ll get a JSON with the recording status and metadata, including the video URL.

Testing and integration #

• Use the example curl requests and responses to test API calls.
• Integrate the API into your workflows by handling the JSON responses and utilizing the returned video URL or request Code for further actions.
• Save changes in the Developer Settings to enable your configurations.

Tips #

• Keep your API key secure and avoid exposing it in public code.
• Experiment with optional parameters to tailor recording requests to your needs.
• Monitor webhook responses to ensure seamless integration with your system.

For more details, refer to the complete documentation under each API section. The dadan Recording Request API documentation provides two primary endpoints: Create Recording Request API and Get Recording Request API.