> ## Documentation Index > Fetch the complete documentation index at: https://docs.iyzpdf.com/llms.txt > Use this file to discover all available pages before exploring further. # Quickstart > Create an API key, make your first request, and understand the default response pattern. This quickstart shows the shortest path to a working server-to-server integration. ## 1. Sign In To The Portal Open `https://portal.iyzpdf.com/login` and sign in to your account. ## 2. Create An API Key Go to the **API Keys** screen, create a new key, and copy the full value immediately. IyzPdf only shows the full secret once after creation. If you need the full workflow, see [API Keys](guides/api-keys). ## 3. Store The Key In Your Server Environment ```bash theme={null} export IYZPDF_API_KEY="iyz_live_your_key_here" ``` Do not embed this key in browser code, mobile apps, or public repositories. ## 4. Send Your First Request The example below renders inline HTML into a PDF. ```bash theme={null} curl --request POST \ --url https://api.iyzpdf.com/v1/convert/html-to-pdf \ --header "X-API-Key: $IYZPDF_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "html": "

Invoice #1042

Total: $99.00

", "options": { "format": "A4", "marginTop": "2cm", "marginBottom": "2cm", "printBackground": true } }' \ --output invoice.pdf ``` ## 5. Read The Response Successful requests return the generated file as an attachment by default. Common success headers: * `X-Request-Id` * `X-Processing-Time-Ms` * `X-Credits-Used` * `X-Credits-Remaining` * `X-RateLimit-Limit` * `X-RateLimit-Remaining` * `X-RateLimit-Reset` If you only want metadata, add an `Accept: application/json` header: ```bash theme={null} curl --request POST \ --url https://api.iyzpdf.com/v1/convert/html-to-pdf \ --header "X-API-Key: $IYZPDF_API_KEY" \ --header "Content-Type: application/json" \ --header "Accept: application/json" \ --data '{ "html": "

Metadata only

" }' ``` Example response: ```json theme={null} { "fileName": "output.pdf", "size": 183240, "creditsUsed": 1, "creditsRemaining": 49, "contentType": "application/pdf" } ``` ## 6. Handle Errors Consistently Errors follow a stable JSON envelope: ```json theme={null} { "error": { "code": "INSUFFICIENT_CREDITS", "message": "You need 2 credits but have 0 remaining.", "creditsRequired": 2, "creditsBalance": 0, "purchaseUrl": "https://iyzpdf.com/portal/credits" } } ``` Typical status codes: * `200` for success * `400` for validation errors * `402` for insufficient credits * `413` for payload size errors * `415` for unsupported file types or media types * `429` for rate limiting * `500` for processing failures