Skip to main content
Import PDF files

How to import PDF files using the YUMPU API

Linus avatar
Written by Linus
Updated over 2 months ago

In order to transfer Pdf files from your computer to your Yumpu account please follow these steps:

Open the command console (Windows) or Terminal (macOS) either by opening the search query on Windows and typing in "cmd" or by searching for the term "Terminal" on your Mac device.
​
Copy and paste the following code snippet into the command console next:


curl -X POST -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" -H "Content-Type: multipart/form-data" -F "file=@filename.pdf" -F "title=My document title" "https://api.yumpu.com/2.0/document/file.json"
​



Please replace the passages marked in bold and italics as follows:
​
​YOUR_ACCESS_TOKEN: replace this text with the API Token located in the "my account" -> "API" tab of your Yumpu account


​filename.pdf: replace this text with the name of the pdf file, saved on your hard drive, you would like to transfer (Attention: the maximum file size cannot exceed 600 MB)

​My document title: replace this placeholder with the title you would like to be displayed for the magazine in your Yumpu account. (Attention: the title provided requires a minimum of 5 characters and cannot exceed the maximum character length of 255 characters)
​
An example for the code segment without placeholders would look like this:



curl -X POST -H "X-ACCESS-TOKEN: F49VNZRO" -H "Content-Type: multipart/form-data" -F "file=@Yumputest.pdf" -F "title=This is my Yumpu test document" "https://api.yumpu.com/2.0/document/file.json"
​



This would, in turn, create an entry for the "Yumputest.pdf" document labelled "This is my Yumpu test document" in the account associated with the respective access token
​
Using this code snippet in sequence by adding the parameter;


&&


in between each new curl segment, you will be able to transfer and create multiple entries for magazines in your Yumpu account.

Did this answer your question?