Skip to Content
Odoo Menu
  • Sign in
  • Try it free
  • Apps
    Finance
    • Accounting
    • Invoicing
    • Expenses
    • Spreadsheet (BI)
    • Documents
    • Sign
    Sales
    • CRM
    • Sales
    • POS Shop
    • POS Restaurant
    • Subscriptions
    • Rental
    Websites
    • Website Builder
    • eCommerce
    • Blog
    • Forum
    • Live Chat
    • eLearning
    Supply Chain
    • Inventory
    • Manufacturing
    • PLM
    • Purchase
    • Maintenance
    • Quality
    Human Resources
    • Employees
    • Recruitment
    • Time Off
    • Appraisals
    • Referrals
    • Fleet
    Marketing
    • Social Marketing
    • Email Marketing
    • SMS Marketing
    • Events
    • Marketing Automation
    • Surveys
    Services
    • Project
    • Timesheets
    • Field Service
    • Helpdesk
    • Planning
    • Appointments
    Productivity
    • Discuss
    • Artificial Intelligence
    • IoT
    • VoIP
    • Knowledge
    • WhatsApp
    Third party apps Odoo Studio Odoo Cloud Platform
  • Industries
    Retail
    • Book Store
    • Clothing Store
    • Furniture Store
    • Grocery Store
    • Hardware Store
    • Toy Store
    Food & Hospitality
    • Bar and Pub
    • Restaurant
    • Fast Food
    • Guest House
    • Beverage Distributor
    • Hotel
    Real Estate
    • Real Estate Agency
    • Architecture Firm
    • Construction
    • Property Management
    • Gardening
    • Property Owner Association
    Consulting
    • Accounting Firm
    • Odoo Partner
    • Marketing Agency
    • Law firm
    • Talent Acquisition
    • Audit & Certification
    Manufacturing
    • Textile
    • Metal
    • Furnitures
    • Food
    • Brewery
    • Corporate Gifts
    Health & Fitness
    • Sports Club
    • Eyewear Store
    • Fitness Center
    • Wellness Practitioners
    • Pharmacy
    • Hair Salon
    Trades
    • Handyman
    • IT Hardware & Support
    • Solar Energy Systems
    • Shoe Maker
    • Cleaning Services
    • HVAC Services
    Others
    • Nonprofit Organization
    • Environmental Agency
    • Billboard Rental
    • Photography
    • Bike Leasing
    • Software Reseller
    Browse all Industries
  • Community
    Learn
    • Tutorials
    • Documentation
    • Certifications
    • Training
    • Blog
    • Podcast
    Empower Education
    • Education Program
    • Scale Up! Business Game
    • Visit Odoo
    Get the Software
    • Download
    • Compare Editions
    • Releases
    Collaborate
    • Github
    • Forum
    • Events
    • Translations
    • Become a Partner
    • Services for Partners
    • Register your Accounting Firm
    Get Services
    • Find a Partner
    • Find an Accountant
    • Meet an advisor
    • Implementation Services
    • Customer References
    • Support
    • Upgrades
    Github Youtube Twitter Linkedin Instagram Facebook Spotify
    +1 (650) 691-3277
    Get a demo
  • Pricing
  • Help
You need to be registered to interact with the community.
All Posts People Badges
Tags (View all)
odoo accounting v14 pos v15
About this forum
You need to be registered to interact with the community.
All Posts People Badges
Tags (View all)
odoo accounting v14 pos v15
About this forum
Help

Trying to request a document signature through the JSON API

Subscribe

Get notified when there's activity on this post

This question has been flagged
apijsonsignature
2 Replies
1461 Views
Avatar
Seb Peterson
Hello. I'm using the JSON API for my CRM and contacts without any problems. I'm now trying to integrate the API for the Signature app... with some issues. When I try to create a signature request, I get an error, but I can't find the documentation to resolve it. Here is my request (Python):

res_create = requests.post(
f"{self.base_url}/sign.request/create",
headers=self.headers,
json={
"ids": [],
"context": {"lang": "en_US"},
"vals_list": [
{
"template_id": template_id,
"message_partner_ids": [xxx],
}
],
},
timeout=30
)

I get this error:
requests.exceptions.HTTPError: 422 Client Error: UNPROCESSABLE ENTITY for url: https://mydb-dev.odoo.com/json/2/sign.request/create

I think I don't have the correct initial "vals_list" values to create this object. How can I find this information?

Thanks in advance.
0
Avatar
Discard
Avatar
Seb Peterson
Author Best Answer

Hi,

thanks for your suggestions. Looking at what happens on the web client network, when requesting a template signature, it looks nothing the CRUD endpoints listed for the JSON API here: https://www.odoo.com/documentation/19.0/developer/reference/external_api.html#api

Web client 1st sends a "web_save" method, model "sign.send.request", 
then a "send_request" method, model "sign.send.request",

Trying to add most of the args in my create endpoint generate  INTERNAL SERVER ERROR.

Very frustrating to not get answers from Odoo support... and not having any documentation for this.

0
Avatar
Discard
Avatar
Cybrosys Techno Solutions Pvt.Ltd
Best Answer

Hi,

The 422 Unprocessable Entity error indicates that the Signature request is reaching Odoo correctly, but the JSON payload is missing required values or does not match what the Signature app expects. The sign.request/create endpoint requires more data than just template_id and message_partner_ids, and the exact structure of vals_list depends on how the Signature template is configured (roles, signers, and required fields). Since the Signature API is not fully documented, the recommended approach is to enable Developer Mode, create a Signature request manually from the Odoo UI using the same template, and inspect the Network tab in your browser to capture the /sign/request/create payload. That request shows the exact fields and structure required for your template. Most 422 errors occur because a required signer role or assignment is missing or mismatched, so ensuring the template is valid, published, and that all signer roles are properly provided will resolve the issue.


Hope it helps

0
Avatar
Discard
Enjoying the discussion? Don't just read, join in!

Create an account today to enjoy exclusive features and engage with our awesome community!

Sign up
Related Posts Replies Views Activity
How to make pagination in JSON-RPC api call ? Solved
api json
Avatar
Avatar
2
Dec 25
8874
Impossible de récupérer les lignes d'une facture à l'aide de la route account.move.line/read
api php json
Avatar
Avatar
Avatar
3
Apr 26
952
Request Document Template Signature using XML-RPC
api signature XML-RPC
Avatar
0
Jul 21
5044
json api
api json java
Avatar
0
Mar 15
7859
Return Only JSON body and not RPC from controller v16
api json controllers odoo16
Avatar
1
Sep 24
3212
Community
  • Tutorials
  • Documentation
  • Forum
Open Source
  • Download
  • Github
  • Runbot
  • Translations
Services
  • Odoo.sh Hosting
  • Support
  • Upgrade
  • Custom Developments
  • Education
  • Find an Accountant
  • Find a Partner
  • Become a Partner
About us
  • Our company
  • Brand Assets
  • Contact us
  • Jobs
  • Events
  • Podcast
  • Blog
  • Customers
  • Legal • Privacy
  • Security
الْعَرَبيّة Català 简体中文 繁體中文 (台灣) Čeština Dansk Nederlands English Suomi Français Deutsch हिंदी Bahasa Indonesia Italiano 日本語 한국어 (KR) Lietuvių kalba Język polski Português (BR) română русский язык Slovenský jazyk Slovenščina Español (América Latina) Español Svenska ภาษาไทย Türkçe українська Tiếng Việt

Odoo is a suite of open source business apps that cover all your company needs: CRM, eCommerce, accounting, inventory, point of sale, project management, etc.

Odoo's unique value proposition is to be at the same time very easy to use and fully integrated.

Website made with

Odoo Experience on YouTube

1. Use the live chat to ask your questions.
2. The operator answers within a few minutes.

Live support on Youtube
Watch now