Latest Content

How to Add a Logo to an OAuth Application

Updated on 21 July, 2026

Add a logo to a Vultr OAuth application so it appears on the customer consent screen, uploaded as a base64 image using the Vultr Console or the Vultr API.

The application logo appears on the consent screen that Vultr customers see when they authorize your OAuth application. Vultr hosts the image itself rather than referencing an external URL, so the consent flow never depends on your server and the branding cannot change after review.

Follow this guide to add a logo to an OAuth application using the Vultr Console and the Vultr API. You provide the image file, and Vultr stores it and serves it from a hosted URL.

Note
Adding a logo requires the organization's root user. A non-root user receives an HTTP 403 Forbidden response. The logo must be an image no larger than 6 MB in JPEG, PNG, SVG, GIF, WebP, or BMP format. You can change the logo only while the application is in Draft or Rejected status. A PendingReview or Active application is locked.
  • Vultr Console
  • Vultr API

  1. Log in to the Vultr Console.

  2. Click the organization name in the top navigation bar.

  3. Click Manage Organization.

  4. Click OAuth Applications.

  5. Click the Edit icon next to the application you want to change.

  6. Under Logo, click Choose file and select your image.

  7. Click Save Changes.

    The logo appears on the application's consent screen.

  1. Encode your image file as base64 and store it in a variable. Replace logo.png with the path to your image.

    console 
    $ LOGO_B64=$(base64 -w0 logo.png)

  2. Send a PATCH request to the Update OAuth Client endpoint to attach the logo. Replace {client-id} with your application id.

    console 
    $ curl "https://api.vultr.com/v2/oauth/clients/{client-id}" \
    -X PATCH \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{
        "logo": "'"${LOGO_B64}"'"
    }'

    A successful request returns the application object with a logo_url field. The logo_url is a Vultr-hosted address and changes each time you replace the logo, so do not hardcode it.

  3. Send a GET request to the Read OAuth Client endpoint to retrieve the application details. Replace {client-id} with your application id.

    console 
    $ curl "https://api.vultr.com/v2/oauth/clients/{client-id}" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

    Verify that the logo_url field contains a Vultr-hosted URL.

Comments