> For the complete documentation index, see [llms.txt](https://docs.toomuchmedia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toomuchmedia.com/api/api-endpoints/external-hit/api-external-hit-join-submit.md).

# /api/external‑hit/join‑submit

## POST /api/external-hit/join-submit

> Record a Join Form Submission

```json
{"openapi":"3.0.2","info":{"title":"API Specification","version":"v1"},"tags":[{"name":"/api/external-hit/join-submit"}],"security":[{"api-key":[],"api-username":[]}],"components":{"securitySchemes":{"api-key":{"type":"apiKey","in":"header","name":"api-key"}},"schemas":{"post_external-hit_join-submit":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["natscode"]}}},"paths":{"/api/external-hit/join-submit":{"post":{"description":"Record a Join Form Submission","tags":["/api/external-hit/join-submit"],"parameters":[{"name":"natscode","in":"query","schema":{"type":"string"},"required":true},{"name":"ip","in":"query","schema":{"type":"string"},"required":false},{"name":"country","in":"query","schema":{"type":"string"},"required":false},{"name":"landing_page_url","in":"query","schema":{"type":"string"},"required":false},{"name":"landing_page_lookup_id","in":"query","schema":{"type":"integer"},"required":false},{"name":"referring_url","in":"query","schema":{"type":"string"},"required":false},{"name":"refurl_lookup_id","in":"query","schema":{"type":"integer"},"required":false},{"name":"loginid","in":"query","schema":{"type":"integer"},"required":false},{"name":"programid","in":"query","schema":{"type":"integer"},"required":false},{"name":"siteid","in":"query","schema":{"type":"integer"},"required":false},{"name":"tourid","in":"query","schema":{"type":"integer"},"required":false},{"name":"campaignid","in":"query","schema":{"type":"integer"},"required":false},{"name":"adtoolid","in":"query","schema":{"type":"integer"},"required":false},{"name":"subid1","in":"query","schema":{"type":"integer"},"required":false},{"name":"subid2","in":"query","schema":{"type":"integer"},"required":false},{"name":"promotionalid","in":"query","schema":{"type":"integer"},"required":false}],"responses":{"200":{"description":"success","content":{"text/php":{"schema":{"$ref":"#/components/schemas/post_external-hit_join-submit"}},"application/json":{"schema":{"$ref":"#/components/schemas/post_external-hit_join-submit"}},"application/xml":{"schema":{"$ref":"#/components/schemas/post_external-hit_join-submit"}}}}}}}}}
```