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.