What is the customer url?

This is probably something basic I’m missing, but I don’t understand the customer_url as well as I should. In most of the documentation, the customer_url is just listed at the top of the code with a different parameter every time. Sometimes the customer_url is generated, when for example you would be creating a customer like so:

        customer = app_token.post('customers', request_body)
        customer_url = customer.headers['location']

Is the customer_url unique? Should I be saving it somewhere? Do I need to generate a new customer URL? If I have the customer’s id, how do I use this to get the customer url? Is there a customer url for the ‘master account’ and each ‘customer’? How do I know which customer_url I should be using?

Hi @jmtichell – The customer URL represents a link to the Customer resource you create using the API. The GUID in the URL is in fact the unique Customer ID assigned to each new Customer. You would use this URL to find the Customer you create via the API.

The Master Account would have an Account URL. Only the Customers you create under your Master Account would have a Customer URL.

You can find the URL for your Master Account by calling the following endpoint (also explained in this Doc) -

API Request:

GET https://api-sandbox.dwolla.com/

. . .

API Response:

{
  "_links": {
    "account": {
      "href": "https://api-sandbox.dwolla.com/accounts/ad5f2162-404a-4c4c-994e-6ab6c3a13254"
    },
    "customers": {
      "href": "https://api-sandbox.dwolla.com/customers"
    }
  }
}

In the above example, the “account” link https://api-sandbox.dwolla.com/accounts/ad5f2162-404a-4c4c-994e-6ab6c3a13254 is your Master Account’s URL.

Yes, you should be saving these URLs as you create resources. Every resource created via the API will have its own unique Resource URL. For example, when you create a funding-source for a Customer, the funding-source would have a unique URL for you to retrieve data through the API,
https://api-sandbox.dwolla.com/funding-sources/fc84223a-609f-42c9-866e-2c98f17ab4fb

Hope that helps!

Thank you @shreya, I was unsure whether it was indeed the unique customer ID or something generated everytime as an additional security measure.