Skip to main content

Callback URLs in Agreements

Redirect users back to your application after they complete their part of an agreement — for a smoother, more integrated signing experience.


Understanding Callback URLs​

A Callback URL is an optional redirect link that users are sent to after completing a specific action, such as signing or approving an agreement. It allows you to maintain control of the user journey and integrate the e-signing flow into your product.


How Callback URLs Work​

  • User Redirection: When a participant finishes their action, they are redirected to the specified Callback URL.
  • Flexible Integration: You can point users to confirmation screens, dashboards, next steps, or any other relevant part of your application.
  • Participant-Specific: Callback URLs can be set individually per participant if needed.

Configuration​

Setting a Callback URL is simple. Include the success_callback_url field when creating or updating a participant or agreement:

{
    "success_callback_url": "https://yourapp.com/next-step"
}

The redirect will happen automatically after the participant completes their signing or approval task.


Best Practices​

  • Match the Flow: Redirect users to pages that clearly reflect what they’ve just completed.
  • Secure the URL: Avoid placing sensitive data in query parameters, and validate incoming traffic on your end if needed.

Why Use Callback URLs?​

Callback URLs help bridge the gap between Zigned’s signing flow and your own application. They keep the experience consistent, reduce friction, and let you guide users through the next steps — whether that’s a confirmation message or onboarding the next participant.