How to use uploadFile - solution

How to use uploadFile - solution

Hi, I've spent a whole day trying to setup the API call for uploadFile and once I figured it out I would like to share how to do it.

In my case I wanted to send a CV as an attachment to a Candidate profile in Zoho Recruit through the API. I'm attaching screenshots from Postman:

As you can see everything here is the same as in the docs, except for the URL beginning (in my region I use for you guys it may be .com). I'm also NOT putting the "content" parameter in the URL.

Now here comes the interesting part:

Here is where content goes. In the body as form-data. The type of the key "content" is "file", not "text" (you can select it when you hover over the key).

After submitting this request the file is attached and you can see the response being successful.
In Postman you can export this request in many popular coding languages, just bear in mind that the code will assume that you're using a local file, so you might have to make changes for files from URL's.

Here's an example Python implementation that grabs files from URL's:

  1. from urllib.request import urlopen
    import requests


    url = ""
    params = {
    "authtoken": <Your Token>,
    "scope": "recruitapi",
    "id": <The id of the record you want to file to be attached to>,
    "type": "Others" //<this is not set in stone check your attachment types>,
    "version": 2,

    files = [
    ('content', urlopen("the url of your file").read())

    r =, params, files=files)

And now I would like to rant a bit. Why cannot I find this information above in the docs? Why are the docs misleading me into using content as a URI parameter which doesn't work at all? Why are there so many tickets in the forum with this exact same problem for the past 8 years and most of them are not solved in a meaningful way?

Come on guys :/

      Zoho SalesIQ Resources

            Zoho TeamInbox Resources

              Zoho DataPrep Resources

                  Zoho CRM Plus Resources

                    Zoho Books Resources

                      Zoho Subscriptions Resources

                        Zoho Desk Resources

                          Zoho Projects Resources

                            Zoho Sprints Resources

                              Qntrl Resources

                                Zoho Creator Resources

                                  Zoho WorkDrive Resources

                                      Zoho Campaigns Resources

                                        Zoho CRM Resources

                                                    Design. Discuss. Deliver.

                                                    Create visually engaging stories with Zoho Show.

                                                    Get Started Now

                                                      Zoho Show Resources

                                                        Zoho Writer Writer

                                                        Get Started. Write Away!

                                                        Writer is a powerful online word processor, designed for collaborative work.