CMAsnap Documentation (1.0.0)

Download OpenAPI specification:

Authenticated links and embedding options for CMAsnap.

Create new CMA report with Tangilla authentication

Main entry point for creating CMA reports with authenticated links.

Note: When using mlsId or address parameters, the system will first attempt to find an existing report for that property. If found, it will load the existing report; otherwise, it will create a new one.

Tangilla Auto-Login

Add ?autoLogin=tangilla to attempt automatic Tangilla authentication:

https://app.cmasnap.com/new?mlsId=PROP123&autoLogin=tangilla

This will redirect users to Auth0 with the Tangilla connection pre-selected, streamlining the login process for Tangilla users.

query Parameters
mlsId
string
Example: mlsId=PROP123456

MLS listing ID - searches for existing report or creates new one for this property

address
string
Example: address=123%20Main%20St%2C%20Austin%2C%20TX

URL-encoded property address - searches for existing report or creates new one at this address

embed
boolean
Default: false

Enable embed mode for iframe usage

autoLogin
string
Value: "tangilla"

Attempt auto-login with specified provider (currently only 'tangilla')

Responses

Embedding

Iframe integration and embedding options

Embed CMA reports in your website

Embed CMAsnap functionality directly into your website using iframes.

Note: The actual URL is /new?embed=true but this documentation is for the embedding functionality.

Basic Embed

<iframe
  id="cmasnap-iframe"
  src="https://app.cmasnap.com/new?embed=true"
  scrolling="no"
  style="width: 1px; min-width: 100%; border: 0; overflow: hidden; height: 500px">
</iframe>

Embed with Property

<iframe
  id="cmasnap-iframe"
  src="https://app.cmasnap.com/new?embed=true&mlsId=PROP123"
  scrolling="no"
  style="width: 1px; min-width: 100%; border: 0; overflow: hidden; height: 500px">
</iframe>

Full Implementation with Auto-Resize

<iframe
  id="cmasnap-iframe"
  src="https://app.cmasnap.com/new?embed=true&address=123%20Main%20St"
  scrolling="no"
  style="width: 1px; min-width: 100%; border: 0; overflow: hidden; height: 500px">
</iframe>

<script src="https://app.cmasnap.com/static/js/embed.js"></script>

<script>
  const cmasnapInt = setInterval(() => {
    if (typeof CMAsnap !== 'undefined') {
      new CMAsnap('#cmasnap-iframe');
      clearInterval(cmasnapInt);
    }
  }, 1000);
</script>

Users will need to authenticate within the iframe on their first visit. Authentication persists across sessions.

query Parameters
embed
required
boolean
Value: true

Must be set to true for embed mode

mlsId
string

MLS listing ID to load

address
string

Property address (URL encoded)

autoLogin
string
Value: "tangilla"

Pre-select authentication provider (e.g., tangilla)

Responses