Skip to main content

Getting Started: Signing Up

Updated over 2 months ago

Getting Started: Signing Up

Getting Started: Signing Up for the Medecision Dev Portal

Follow this step-by-step guide to access the Medecision Dev Portal, view APIs, and register your own applications.


Step 1: Access the Dev Portal


Step 2: Sign Up for an Account

  1. Click “Sign Up”

  2. Use your Medecision-approved email address

  3. Submit the form

📢 Note: Your account will not be active until an administrator approves it.


Step 3: Wait for Approval

  • Internal Users: Raise a request via the internal Ops Support Portal.

  • Client Users: Submit a request to the Medecision Support Portal (e.g., Aerial Service Desk).


Step 4: View Available APIs

  1. After login, you’ll see a list of APIs available to your organization.

  2. Click into a service to view Swagger documentation and example requests.


Step 5: Create a New App and Generate Credentials

  1. Click your profile icon (top-right)

  2. Select “My Apps” → Click “New App”

  3. Fill in the form (name, description, etc.)

  4. Click “Create” to generate an API Key

🔐 Important: You will only see the API Key once—store it securely.


🔗 Step 6: Register for API Access

  1. Go back to the service you wish to use

  2. Click “Register”

  3. Choose the application you created earlier

  4. Click “Request Access”

✅ Access is typically granted automatically after request.


Step 7: Test in Postman or Insomnia

  1. Click “View Raw” on any service

  2. Download the API spec (OpenAPI)

  3. Import into your API client


Optional: Using x-md-token Header

For services that require a JWT token instead of an API key:

Refer to:\ 👉 JWT Integration Guide

Not all steps are required—Dev Portal-issued keys may be sufficient for basic access.


For further help or to request elevated access, reach out via your Support Portal.

Did this answer your question?