All Collections
Integration/Interfaces
How to import your Pdf files to your Yumpu account using the API connection
How to import your Pdf files to your Yumpu account using the API connection
Linus Mathis avatar
Written by Linus Mathis
Updated over a week 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?