Set up EU API authentication and create a lead for a Danish merchant using Denmark-specific onboarding values.

Authentication and environments

Base URLs for the EU platform

Use the EU base URL for your environment.

Environment	Base URL
EU (production)	`https://youlendapi.com`
EU (staging)	`https://partners.staging-youlendapi.com`

Authentication URLs (to request an access token)

Request an access token from the matching EU authentication URL. Follow the Authentication guide for token request details.

Environment	Authentication URL
EU (production)	`https://youlend.eu.auth0.com/oauth/token`
EU (staging)	`https://youlend-stag.eu.auth0.com/oauth/token`

Onboarding APIs

Parameter callouts

Use these Denmark-specific values when you create a lead:

Parameter	Denmark value or format
`companyType`	Use a value from Denmark company types, such as `ApS` for a private limited company.
`companyNumber`	The company's eight-digit CVR (Danish business registration) number.
`contactPhoneNumber`	`+45` followed by eight digits, for example `+4522334455`.
`countryISOCode`	`DNK`
`loanCurrencyISOCode`	`DKK`

Example Create a lead request

Send a create-lead request with the merchant's company and contact details. Replace the example values with the merchant's information.

{
  "thirdPartyCustomerId": "DK_CUSTOMER_12345",
  "confirmedCreditSearch": true,
  "countryISOCode": "DNK",
  "loanCurrencyISOCode": "DKK",
  "keyContactName": "Lars Jensen",
  "companyType": "ApS",
  "companyName": "Nordic Design ApS",
  "tradingName": "Nordic Design",
  "companyNumber": "12345678",
  "companyWebsite": "https://nordicdesign.dk",
  "registeredAddress": {
    "line1": "Nørrebrogade 20",
    "city": "Copenhagen",
    "region": "Capital Region",
    "areaCode": "2200",
    "countryISOCode": "DNK"
  },
  "contactPhoneNumber": "+4522334455",
  "contactEmailAddress": "[email protected]",
  "additionalInfo": {
    "youLendSales": "false",
    "language": "da"
  }
}

Example Create a lead response

Save the returned leadId for subsequent lead operations.

{
  "leadId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "leadURL": "string",
  "signUpURL": "string",
  "openBankingURL": "string"
}

Example Update significant persons request

Use the returned leadId to update significant persons (the business's directors and beneficial owners). For European leads, add at least one person with typeOfPerson set to Director or DirectorAndBeneficialOwner before submitting the lead. A Director runs the business without owning it; a DirectorAndBeneficialOwner both runs and owns it.

Field	What to provide
`firstName`, `surname`	Each person's name; both fields are required and allow up to 255 characters.
`typeOfPerson`	The person's role; use a value from the type of person reference.
`dateOfBirth`	A date showing the person is at least 18 years old.
`address.line1`, `address.city`, `address.areaCode`, `address.country`	Required address fields; include the building number and road name in `line1`.
`percentageOwned`	If you provide ownership percentages for multiple people, ensure their total does not exceed 100.
`placeOfBirth`	If you provide it, use `{city}, {country}` with a three-letter country code, for example `Copenhagen, DNK`.

Send the request to the Update significant persons endpoint using the returned leadId. Replace the example person's details with their actual information.

{
  "significantPersons": [
    {
      "firstName": "Lars",
      "surname": "Jensen",
      "typeOfPerson": "DirectorAndBeneficialOwner",
      "address": {
        "line1": "Nørrebrogade 20",
        "city": "Copenhagen",
        "areaCode": "2200",
        "countryISOCode": "DNK"
      },
      "dateOfBirth": {
        "year": 1985,
        "month": 6,
        "day": 15
      },
      "emailAddress": "[email protected]",
      "mobilePhoneNumber": "+4522334455",
      "percentageOwned": 100
    }
  ]
}

If the API returns 422, correct the fields identified in the significant-person validation rules and retry before submitting the lead.